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Chapter 1 Introduction 


1.1 Before You Begin 


Target System 


MultiVendor Interface (MVI) is an environment you can use to interface external vendors’ 
PLCs and RTUs to Process Stations in the Advant Controller 400 Series. 


MVI consists of a Development Environment, a Runtime Environment and a Demo Protocol 
Handler. 


MVI Development 
Environment 


SR511 


Voltage 
Reg. 


nw 2 30 4o<g] = 


SB510 


Battery 
Charger 


one 
CER 


PLC System 


Windows NT 4.0 
Personal Computer 


=e 
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Figure 1-1. MultiVendor Interface 


The MVI Development Environment is the software base for the development of alien 
RTU/PLC protocols. You can use protocols developed in MVI in any controller in the Advant 
Controller 400 Series. The MVI Development Environment runs on a Personal Computer with 
Windows NT 4.0. 


The MVI Runtime Environment is the environment in the target system where the Protocol 
Handler developed executes. The Protocol Handler is the only part that you, as user of the MVI 
Protocol Development Kit have to develop. 
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The Demo Protocol Handler serves as an example of how to implement a Protocol Handler 
using MVI. 


This manual describes MVI. It provides step-by-step instructions for installation, configuration 
and development of new protocols using MVI. It is targeted towards engineers creating alien 
protocols for Advant Controllers within the ABB OCS. 


Knowledge of configuration and application programming of the Advant Controller 400 Series, 
as well as C programming and general communication protocol knowledge, is required. 
Knowledge of configuration and application programming of some of the MVI standard 
protocols is recommended. 


1.2 Equipment Requirements 


1.2.1 Target System 


1-2 


Communication Hardware in the Advant Controller 410 


° CI538 Communication submodule, equipped with 1 MB RAM and | MB Flash PROM, 
for connection of one or two communication links. 


The communication submodule is connected to one of the four submodule positions on the main 
processor module PM150. 


Communication Hardware in the Advant Controller 450 


° CI538 Communication submodule, equipped with 1 MB RAM and | MB Flash PROM, 
for connection of one or two communication links. 


° A free submodule position for the CI538 submodule on one of the following submodule 
carriers: 


— $C510 Carrier without local processor (one submodule position can also be used for 
other functions, for example MB 300). 


— $§C520 Carrier with local processor (one submodule position can also be used for 
other functions, for example MB 300). 
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Modems and Cables 


The communication submodule CI538 is equipped with two independent, CCITT V.24 
(RS232-C), asynchronous communication ports. For connection of the serial link, the following 
modems and cables are recommended: 


° Westermo LA-01! 
Full duplex modem for multidrop communication up to 10 km. 


° TC562 
Full duplex modem for cable length up to 10 km. Point-to-point up to 1 km at 19200 bps. 
Power 24 V DC. 

° TKS77 


TK577 is a 3 m cable with a nine-position D-Sub Connector Receptacle (female) for 
connection to one port on the front of the CIS538 submodule and a 25-position D-Sub 
Connector Plug (male) for connection to the modem LA-01 or Uniline 2.4. (For more 
information on hardware setup, see Section 2.2.1, Hardware.) 


° TKS95 
Cable with a nine-position D-Sub Connector Receptacle (female) for connection to one 
port on the front of the CI538 submodule and a 9-position D-Sub Connector Plug (male) 
for connection to the modem TC562. 


° Bus cable with two twisted pairs, each pair individually shielded, minimum conductor area 
0.22 mm. You can use the following cable or a similar cable: 


— Belden Type 9406 

— Kabelmetal Type DUE 4552 
— Alpha Type 6032 

— Norsk Kabel Type 06802. 


1.2.2 Development System 
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Personal Computer 


° Windows NT 4.0 Personal Computer with floppy drive (1.44 MB) and one free RS232-C 
serial communication port. 


Software 

° Tornado 1.0.1 for Windows NT 4.0 and Target Architecture MC680X0 
° MV Base *3.0. 

° WinSDE (optional) 


PROM Programmer 
° A PROM programmer which supports programming of 28F020 type Flash PROMs. 


1. Ordered from Westermo Teleindustri AB, St. Sundby, Sweden. 
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Engineering Tools 


To build the data base and the PC program in the AC 400, you need an: 


Engineering Station. 


1.3 How to Use This Book 


Figure 1-2 shows the basic structure of the Advant System’s documentation. Each document, 
describing either hardware or software, is built around this structure to make it easy for you to 
locate related information in any of the documents. 
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Product 
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Figure 1-2. Manual Organization Diagram 


Introduction 


Chapter 1, serves as an introduction to the MVI Development Environment. 


Installation 


Chapter 2, tells you how to set up the communication hardware in AC400. You can also find 
descriptions of how to install the software, the shut-down and start-up procedures, and how to 


verify correct operation after power-up. 


Configuration/Application Building 


Chapter 3, gives you a description of how to configure and use the MVI Development 
Environment. The chapter includes a tutorial which describes the development of a typical 
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Section 1.4 Conventions 


Protocol Handler. In Section 3.4, Application Procedures, you are given brief guidelines on how 
to break your application down into appropriate modules along with a step-by-step description 
of the different stages in the development of a communication Protocol Handler. How to build 
an application for the MVI Demo Protocol is also described. The remainder of the chapter is 
reference material. 


Runtime Operation 


Chapter 4, provides information on how to operate some of the MVI facilities. 


Maintenance 


Chapter 5, provides help and documentation relative to errors that may occur when you are 
using the MVI Development Environment. 


All input values to data base elements which require you to enter the value are boldfaced. 


All commands described, which are given on the command line in the development system or in 
the target system, are boldfaced. 


All references are in italics. 


All program code examples are presented in the font shown below: 
main () 

{ 

/* This is a sample program */ 

printf (“Hello world! \n") H 

} 


-> Prompt in VxWorks shell. 
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1.5 Related Documentation 


For further information about configuration and application programming, refer to the following 


documents. 
Advant OCS Advant OCS Advant OCS Tornado 
Advant Controller MasterBus Installation Documentation 
400 Series 
MultiVendor Interface MasterNet Advant OCS omene te 
User’s Guide User’s Guide Installation Rules User’s Guide 


AMPL Configuration 
AC 400 Series 
Reference Manual 


PC Elements AC 400 Series 
Reference Manual 


Data Base Elements 


AC 400 Series 
Reference Manual 


Advant Controller 410 
User’s Guide 


Advant Controller 450 
User’s Guide 


Figure 1-3. Related Documentation Tree 


1.6 Release History 


Table 1-1 lists the development of MVI Development Environment Release History. 
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(Windows version) 


Table 1-1. Release History 


Version 


Description 


1.0 


Initial Release for Advant Controller 400 Series — Internal use only. 


2.0 


Initial External Release for Advant Controller 400 Series. 


3.0 


Release with the XMS host API, and NT as development system. 
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Section 1.7 Terminology 


Abbreviations, acronyms and terms that you should be familiar with: 


AC 400 is an abbreviation for the Advant Controller 400 Series (Advant Controller 410 
and Advant Controller 450). 


AMPL is an acronym for the ABB Master Programming Language. AMPL is a function- 
block language with graphic presentation that is specifically oriented towards process 
control. The AMPL is used for configuration and application building in Advant 
Controllers. 


Controller refers to Advant Controllers. 


DAT is a concept in the data base that holds a data value (one Real (4 bytes), one Integer 
(2 or 4 bytes) or 32 Boolean values). 


DB is an abbreviation for data base. 


MB 300 or MasterBus 300 is a high-speed bus used to interconnect Controllers, Operator 
Stations and Communication Stations. 


MP is an abbreviation for the ABB MasterPiece. 


MVB (Multi Vendor Interface Data Block) is the data base element defining the command 
used for control of slaves and is also the data base element used for data transfer. It is used 
for transfer of block of data in an Advant OCS network. 


MVIL is an abbreviation for the Advant OCS MultiVendor Interface. 
PC program (Process Control program) is a program written in AMPL. 
RTU is an abbreviation for Remote Terminal Unit. 


Tornado is the development environment for the VxWorks real-time operating system, 
used for the MVI Runtime Environment. 


WinSDE Software Development Environment is an environment for project management 
developed by ABB. 


The MultiVendor Interface Environment consists of the following base components: 


MVI Development Environment. 
MVI Runtime Environment. 


MVI Demo Protocol. 
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Target System MVI Development 
Environment 


AC410/450 Controller, 


MVI Runtime Environment CI538 


agiao-e-aynaxOTO 


30 -+n<M 


Host System Interface 


ee il 


Protocol Handler Interface Ss 


erste Protocol Pe. ane 
Services Handler Windows NT 4.0 
Personal Computer 


UART Device Driver 


UART Controller 
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UART Hardware 


Figure 1-4. MultiVendor Interface 


MVI Development Environment 


The MVI Development Environment is the software base for the development of RTU/PLC 
protocols. It consists of Tornado which provides a set of tools for building the protocol 
developed, WinSDE for project management (optional); and a set of header files and object 
modules which define the MVI runtime types, service functions and devices.Tornado includes 
an editor, compiler, linker and remote debugger. The MVI Development Environment is 
running on a Windows NT 4.0 Personal Computer. 


The only thing that you need to develop is the Protocol Handler. Everything else is included in 
the MVI Runtime Environment. 


A serial port on the Personal Computer is used for communication with the target system during 
development. The protocol used is Raw Serial, which is a protocol for connecting the Tornado 
environment to a target over a serial line. 
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MVI Runtime Environment 


The MVI Runtime Environment is the environment in which the protocol developed is running. 


AC410/450 Controller 
MVI Runtime Environment Cl538 


Host System Interface 


Protocol Handler Interface 
S 
y 
s || Protocol Protocol 
t || Services Handler 
e 
m 


edrs--oa9 a OTTO 


UART Device Driver 


UART Controller 


UART Hardware 
Figure 1-5. MVI Runtime Environment 


Besides the operating system, the MVI Runtime Environment consists of a number of library 
modules comprising the interfaces and support functions used by the Protocol Handler. 


° MVI UART Interface, consisting of the UART device driver and the UART controller, is 
the interface towards the UART hardware. It provides functions for: 


— Initializing software and UART hardware. 


— Activating/deactivating trigger actions. The UART can be set to trigger on different 
trigger conditions such as a certain number of characters, one or several (up to five) 
trigger characters with an and/or condition between them, or a combination of the 
above. You can also specify whether you want the trigger character(s) and/or the 
characters that come before the trigger character(s) to be included in the message or 
ignored. 


— Writing and reading messages to/from the serial link. 


— Waiting for an event from the UART to occur. The mechanism for waiting on events 
from one or several of the devices supported enables a Protocol Handler to suspend 
itself on the UART and possibly other devices such as a Watchdog Timer or a FIFO. 
The execution is then resumed when an event occurs on one or several of the devices 
on which it has been waiting. 
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° MVI Protocol Services is a set of support functions for the Protocol Handler. They provide 
functionality for: 


— Creating, opening, initializing and closing devices. 

—  Read/write from/to devices, that is, the UART. 

— Allocating, initializing and deallocating data structures. 

— Initializing interfaces, that is, MVI Protocol Handler Interface. 

— Accessing certain parts of data structures. 

— Task suspension on one or several devices, waiting for events to occur. 


— Establishing and taking down connections between the host system and a node on the 
serial link. 


— Calculating check sums using a number of different algorithms. 


° MVI Protocol Handler Interface is a set of functions for communication with the host 
system. 


MVI Demo Protocol 


The MVI Demo Protocol included in MVI is a simple protocol provided as an example of how a 
Protocol Handler can be implemented. 
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Chapter 2 Installation 


2.1 Site Planning Environment 


2.2 Setup 


2.2.1 Hardware 
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See the Advant OCS Installation Rules manual for guidelines on earth connection, grounding, 
power supply and so forth. 


The following requirements apply for the Development system: 

° Personal Computer with Windows NT version 4.0. 

° Tornado 1.0.1 for Target Architecture MC680X0 installed. 

° WinSDE installed (optional). 

The following requirements apply for the Advant Controller system: 

° Advant Controller 410, with a CIS538 communication submodule or 


° Advant Controller 450, with a SC510 or SC520 carrier and a CI538 communication 
submodule. 


The following hardware must be available for the development: 

° Advant Controller 410 or, 

° Advant Controller 450, with a SC510 or SC520 carrier. 

° CI538 communication submodule. 

° Windows NT 4.0 Personal Computer with one free serial port. 

° A PROM Programmer capable of programming 28F020 type Flash PROMs. 


The C1538 submodule is equipped with two independent, CCITT V.24 (RS232-C), 
asynchronous communication ports, see Figure 2-1. 


° In Advant Controller 410, the CI538 submodule is connected to one of the four submodule 
positions on the main processor module PM150, see Figure 2-4. 


° In Advant Controller 450, the CI538 submodule is connected to a free submodule position 
on one of the following submodule carriers: SC510 or SC520. Figure 2-1 shows two 
CI538 submodules connected to a SC510 carrier. 
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2 F= FAULT LED 
ES pune R= RUN 
ane * port 1 saat 
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SUBMODULE 2 


Figure 2-1. SC510 Carrier and CI538 Submodule 
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The setup for each port on the CI538 submodule is accomplished with the data base element 
MVIMOD!. There are no strappings on the CI538 submodule and no strappings on the carrier 
boards SC510 and SC520. 


MVI1 


MV IMOD 
(344.1) 


S14 Base part 


S2-}Chl Comm. Param. 


S31Ch2 Comm. Param. 


E WARNING + 


M 
Ss 
ATION ERRTYPE 
s 
B 
Pp 
R’ 


L 
HMNHNVHNWE 


VARIANT NET1 NET2 
E CHANNEL1 CHANNEL2 


Zz 
1e) 
UO 
E 


Base part Chi Comm. Param. Ch2 Comm. Param. 


Figure 2-2. Overview of the MVIMOD Data Base Element 


MVI1 
MVIMOD 
(344.1) 
MVI1 1 ~ NAME WARNING | 16 
0 3-| BUS ERR | 17 
0 4— STATION ERRTYPE | 9 
0 5— POSITION 
0 6— SUBPOS 
1 10— IMPL 
A: 1 SERVICE 
C1534 7-| TYPE 
Vv02 g — VARIANT 
0 18— NODE 
0 224 NET1 
62 4 CHANNEL1 
0 23 + NET2 
63 4 CHANNEL2 


Figure 2-3. Data Base Element MVIMOD for MVI Communication Submodule CI538 


1. The call name for the data base element is MVIMOD and the element type is MVI. 
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You must check or fill in correct values on the MVIMOD data base element (Element type is 
MVI and call name is MVIMOD). For further description, please refer to the Data Base 
Elements Advant Controller 400 Series Reference Manual. 


Table 2-1. Properties for the Data Base Element MVIMOD 


Terminal ’ Value in | Value in a, 
No. Terminal AC450 AC410 Description 
- MVIMOD 1-5 1-2 CI538 submodule number. Record number for the MVIMOD 
Record data base element for the MVI port defines the submodule 
number number. Submodule numbers 1 - 5 are reserved to other 
modules than MVI. 
Record No 1 => submodule = 7 
Record No 2 => submodule = 8 
Record No 3 => submodule = 9 (only valid for AC450) 
Record No 4 => submodule = 10 (only valid for AC450) 
Record No 5 => submodule = 11 (only valid for AC450) 

1 NAME Unique NAME of the element. 

3 BUS 0 0 Not used 

4 STATION 0 0 Not used 

5 POSITION 2-8 1 POSITION of the carrier board in the CPU rack, see figure 
below. To change the POSITION in operation mode, the 
IMPL must be set to 0. See figure below. 

6 SUBPOS 1-2 1-4 SUBPOSition on the carrier board, see figure below. To 
change the SUBPOS in operation mode, the IMPL must be 
set to 0. See figure below. 

10 IMPL 1 1 IMPLemented = 1 to set C1538 submodule in normal 
operation 
0 = the module is spare 
11 SERVICE 1 1 To restart the communication module set the terminal 
SERVICE to 0 and back to 1. 
7 TYPE C1534 Cl534 ~—‘| Always C1534 (not C1538!) 
8 VARIANT Vvo1 vot Not used 
18 NODE 1-99 1-99 Set to AC 400’s own node number. If node number of the 
AC 400 is already defined, NODE can only be set to that 
node number. In order to modify a node number >0, a 
COLD START of the AC 400 is necessary. 
16 WARNING 0-1 0-1 WARNING flag indicating non-fatal errors. PC connection 
data type = B(r) 
17 ERR 0-1 0-1 ERRor flag indication hardware or configuration error. 
PC connection data type = B(r). 
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Section 2.2.1 Hardware 


Terminal Tivnninal Value in | Value in Descridiion 
No. Ac450 | AC410 P 
9 ERRTYPE 0-n 0-n ERRor TYPE. See Section 5.3, Error Messages for 

translation. PC connection data type I(r). 

22 NET1 0-9 0-9 Local control NETwork number for port 1 and 2. In order to 

23 NET2 modify the already set network number, a COLD START of 
the AC 400 is necessary. All local control network numbers 
in the AC 400 must be unique. 
Use NET’n’ = 0 if the port ‘n’ is not used. 

62 CHANNEL 1 : - Name of corresponding MVICHAN elements. 

63 CHANNEL2 - - 
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NOTE! 


That the TYPE terminal must have the value CI534 instead of the more natural 

CI538 is due to the fact that the controller software (AC410 and AC450) not yet 
has been updated for the CI538 product. The VARIANT terminal must be set to 
VO01 even though this has no effect on your protocol. 


AC 410 


SUB- vA 


POSITION 


POSITION ALWAYS = 1 


Figure 2-4. Position and Subposition for CI538 Submodule in Advant Controller 410 
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Figure 2-5. Position and Subposition for CI538 Submodule in Advant Controller 450 


Cable for MVI Communication 


The cable TK577 has a DE9 socket for connection to one port on the front of the CI538 
submodule and a DE25 PIN for connection to the modem. The connection between the 9- and 
the 25-PIN connectors is shown in Table 2-2. No wiring of the modem signals is made in the 
cable TK577. The cable TK595 has a DE9 socket for connection to one port of the CI538 
submodule and a DE9 PIN for connection to the modem. 
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Table 2-2. Description of Connections for MVI Communication per CCITT V.24 
-_ . No. in 9-PIN | No. in 25-PIN eheeuen 
Description Signal Connaciae Connector CCITT V.24 |IN ~<q—— 
—— > OUT 

Data Carrier Detect DCD 1 8 109 <_——— 
Receive Data RD 2 3 104 <= 
Transmit Data TD 3 2 103 —_ > 
Data Terminal Ready DTR 4 20 108/2 — > 
Signal Ground SG 5 7 102 <= S 
Data Set Ready DSR 6 6 107 <= 
Request To Send RTS 7 4 105 — 
Clear To Send CTS 8 5 106 = _ 
Ring Indicator RI ) 22 125 ~_——— 
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If the port is set up for full duplex handling of modem signals, you can wire the cable 
TK57/TK595 as shown in Figure 2-6. The setup of modem signals can also be strapped in the 
modems. 


oe No. in 9-PIN 
D F 
Escription Signal Connector at MVI-side COHT v.24 


Request To Send 
Clear To Send 
Data Set Ready 


Data Carrier Detect 


Data Terminal Ready 


Figure 2-6. Wiring for Full Duplex Handling of Modem Signals. 
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T+3 oR- 
Transmitter Receiver 
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1) Connect shield only at one end (Transmitter) to avoid loop currents. 


Figure 2-7. Cables and Modems in a Full Duplex Point-to-point Connection 
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Cable for Raw Serial Communication 


The cable for Raw Serial communication has a 9-position D-Sub connector receptacle (female) 
for connection to one serial port on the Windows NT Personal Computer and a 9-position D-Sub 
connector receptacle (female) for connection to one port on the front of the CI538 submodule. 

The connection between the 9-PIN connectors is shown in Table 2-3. 


Table 2-3. Description of Connections for Raw Serial Communication per CCITT V.24 


Description | Signal | NO-iNSPIN | Non OPIN | Compyag | mg 
—— OUT 

Data Carrier Detect DCD 1 1 109 <= — 
Receive/Transmit RD/TD 2 3 104 <= 
Data (7) —_ 
Transmit/Receive TD/RD 3 2 103 —_ 
Data <_ 
Data Terminal Ready DTR 4 4 108/2 —_ 
Signal Ground SG 5 5 102 =P 
Data Set Ready DSR 6 6 107 = 
Request To Send RTS 7 7 105 —_ > 
Clear To Send CTS 8 8 106 = — 
Ring Indicator RI ) 9 125 = 


(1) Note that Receive Data and Transmit Data are crossed. 


2.2.2 Software 


Always start by installing Tornado. After that, MVIBase and WinSDE can be installed, see 
below. 


2.2.2.1 MVIBase and User Development Structure 


MV IBase is installed in an WinSDE type of product structure and the User Development 
Structure is created by the installation program. Figure 2-8 shows the directory structure for the 
MVI Development Environment. 
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Figure 2-8. Directory Structure for the MVI Development Environment 


The MVIBase product is delivered on two floppy disks (1.44 MB). 

Before installing MVIBase, make sure that Tornado is installed on the Personal Computer. 
To install the MVIBase product, take the following steps: 

1. Log in as the same user that installed Tornado. 

2. Insert disk 1. 


3. Inthe NT Explorer, go to the floppy drive (normally A-) and double click on setup.exe. 
The installation program starts. 


4. Follow the instructions given by the installation program. When asked, insert disk 2. 


5. During the installation, there will be a question for the name of the protocol that is to be 
developed with MVIBase. This name is used to create development directories. If no name 
is entered, the protocol directory will be named “UserProtocol“ 


The installation not only installs the MVIBase files, it also creates the development directories 
and modifies Tornado so that its menus contain special entries that allow the MVIBase user to 
develop, build and debug his protocol in a user-friendly fashion. 
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Installation of WinSDE consists of loading the software from the CD. 
The installation procedures are described in the product package. 


2.3 Shut-down Procedures 


Kill the Target Server (in Tornado) to shut down the communication between the development 
system and the target system. 


Set the terminal SERVICE to 0 on the CI538 data base element to shut down the communication 
on the link. The communication is also stopped when the Advant Controller 400 is in 
configuration mode (mode P2, indicated on the front of the main processor module). 


2.4 Start-up Procedures 
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Launch a Target Server (in Tornado) to start up the communication between the development 
system and the target system, see the Tornado documentation. 


To start up the communication link, you must set up the hardware and the data base element 
MVIMOD, as described in Section 2.2.1, Hardware. You must also set up the data base 
elements MVICHAN and MVINODE, as described in Section 3.5.7, Protocol Configuration 
and Application Building for Advant Controller 400. 


The C1538 submodule always restarts if you restart the Advant Controller 400 in any way. The 
CI538 also restarts when the terminal SERVICE on the CI538 element is changed from 0 to 1. 


Check all the system messages when you restart the CI538 submodule. All configuration errors 
are reported at start-up. Error messages with task name MVIxxx or HLxxx, sent from the MVI 
Runtime Environment, are translated in Section 5.3, Error Messages. 


NOTE 


Some errors are only reported once. 
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2.5 Product Verification 
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When the CI538 submodule is correctly installed, the corresponding configuration data base 
elements are filled in and the controller is in operation mode, the following should be indicated: 


° The green LED indicator on the front of the CI538 submodule must be lit. 
° Data base element MVIMOD Terminals ERR and ERRTYPE = 0. 


When the connection to a PLC is established, the following applies for the STATUS] in the 
MVINODE data base element for the corresponding PLC: 


° Link Status (bit 0) = 1 

° For more information regarding the PLC Status information, see Table 3-8 and Table 3-9. 
The MVICHAN element must show the following when the link is connected: 

° DSR = 1 

° CTS = 1 (full duplex) or toggling between | and 0 (half duplex) 

° DCD = | (full duplex) or toggling between 1| and 0 (half duplex). 


NOTE 


Displayed values from the MVICHAN element on the engineering station are not 
always synchronized to the actual value change of the modem signals; short 
pulses may not be displayed. 
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Chapter 3 Configuration/Application Building 


3.1 Design Consideration 


Before starting with the design, your first consideration is to investigate if the protocol has a 
well-defined Data Link layer. If it does, then consider whether or not the Protocol Handler 
should be split into two tasks: 


° Network and/or Function Handler 
° Data Link Handler. 


If, on the other hand, no distinct Data Link layer exists in the protocol, include the Protocol 
Handler function in one task. 


If both slave and master modes of execution are going to be implemented (for master/slave 
protocol types), these two modes should be handled by two separate functions, sharing a 
number of common functions. 


The Host Interface is implemented to isolate the Host System (process station) from the 
Protocol Handler. The MVI Protocol Handler Interface is used for communication between the 
Protocol Handler and the Host Interface. The MVI Protocol Handler Interface is described in 
Section 3.5.5, MVI Protocol Handler Interface. 


A start-up function is implemented to create devices used by the MVI Runtime Environment, 
the Protocol Handler and the Host Interface. The start-up function also spawns the Host 
Interface tasks and the Protocol Handler task. 


A Protocol Handler is normally divided into a number of different parts: 
° Initialization 
— Initialize protocol variables and data structures 
° Setup 
— Handle setup information from host system and initialize devices such as the UART 
° Runtime master 
— Main loop for master 
° Runtime slave 
— Main loop for slave 
° Error handling 
— Handling of various error conditions 
° Termination 


- Release all allocated resources 
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There are two alternate designs possible for the Protocol Handler design: 
° State machine, where each state handles one of all possible events. 
° Conventional multiple handling switch statement, handling all possible events. 


The convention for task names on the CI538 communication submodule, which must be 
followed, is described in Figure 3-1. 


Task Name = txxxxxxnn, where 


XXXXxXxX = MviHdl for the Protocol Handler 
or Network Handler 


XXXXXxX = MviDLL for the Protocol Handler 
Data Link Handler 


XXXxXxXx = HLyyyy for the Host Interface, where 
Yyyy = Setu for the Setup Request function 

yyyy = Wdog for the Watchdog function 

Yyyy = Stat for the Status function 

Yyyy = LCmd for the Local Command function 

Yyyy = LRsp for the Local Response function 
Yyyy = UCmd for the Upstream Command function 
Yyyy = DRsp for the Downstream Response function 


01 for Task Instance One 
02 for Task Instance Two 


nn 
nn 


Figure 3-1. MVI Task Name Convention 


The reason for using this convention is that the task name is part of the system messages which 
are sent from the CI538 submodule (using mviSysMess) to the Advant Controller 400 Series 
process station. They translate to the system message format used in the process station. This 
translation is described in Section 5.3, Error Messages. 


3.2 Capacity & Performance 


3-2 


Capacity and performance depends on implemented protocol. A general rough estimation is that 
you can use 70 percent of the communication speed for messages. With a message header and 
trailer overhead of 20 percent, the data transfer rate, in characters/second, would be: 
(0.7/1.2)*(speed in bps)/(# of bits per char). 


The CI538 submodule, in master mode, can handle a total of 55 slave nodes, divided on two 
ports. One single port can handle up to 32 slave nodes. 


As slave node, each port can communicate with one master node. 
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Section 3.3 Tutorial 


This section contains a tutorial on how to implement PLC/RTU protocols in the MVI 
Development Environment. The code for this tutorial is the Demo Protocol Handler included in 
the MVI Development Environment. For a detailed description of WinSDE and WinSDE 
related commands, refer to the WinSDE documentation. 


NOTE 


This tutorial assumes that MVIBase is installed according to Section 2.2.2.1, 
MVIBase and User Development Structure. 


Create a PROMmed Debug System 


1. 
2: 


Start Tornado. 


From the Project menu, choose: 
DemoProtocol: Build a I channel DEBUG version WITHOUT a protocol (CI538Debug) 


This generates a MVI system load image (C]538Debug) without the Demo Protocol 
Handler. The Handler will be dynamically downloaded later. It also generates a Motorola 
S-record file (CI538Debug.hex) of the load image, which is used by the Flash PROM 
programmer. Both files reside in the <disk>:\MVIProtocols\DemoProtocol\work directory 
(<disk> denotes the hard disk where MVIBase was installed). 


Download the S-record file to the Flash PROM programmer and make the PROMs. 


Install the four Flash PROMs (1MB) on the CI538 submodule, placed as shown in 
Figure B-1. 


Build Object Modules 


5. 


In Tornado, open the <disk>:\MVIProtocols\DemoProtocol\work\mviDemo.c file with the 
built-in Tornado editor. Go to the function protHndlMain(). Go through the source code for 
the Demo Protocol Handler entered in the editor. 


Build the object module from the source code using the Project menu command 
DemoProtocol: Compile the Demo protocol handler file 


This will create the module mviDemo.o. 


Build Application in the Advant Controller 400 Process Station 


7. 


Create and fill in the values in the MVIMOD data base element as described in Section 
2.2.1, Hardware and Appendix A, MVI Demo Protocol Configuration. 


Create and fill in the values in the MVICHAN data base element as described in Section 
3.5.7.1, MVICHAN Data Base Element. and Appendix A, MVI Demo Protocol 
Configuration. 
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10. 


11. 


12. 


Create and fill in the values in the MVINODE data base element as described in Section 
3.5.7.2, MVINODE Data Base Element. and Appendix A, MVI Demo Protocol 
Configuration. 


Create and fill in the values in the MVB data base element as described in Section 3.5.7.3, 
MVI Data Block Element (MVB). and Appendix A, MVI Demo Protocol Configuration. 


Build the PC program for data flow control using the type circuits described in Section 
3.5.7.6, PC Program Layout. and Appendix A, MVI Demo Protocol Configuration. 


Set the Advant Controller 400 process station in Operation mode using the command 
diconfig. 


Download to Target and Start MVI Runtime Environment 


13. 


14. 


15. 


16. 


In Tornado, initiate the Target Server connection between the host and target by choosing 
the menu item: 


Tools -> Target Server -> “DemoProtocol: Demo Debug Target (CI538Debug)” 
A window that logs the connection appears. Minimize it. When you want to break the 


connection to the target, you just kill this window and then the Target Server exits. 


From the Tornado Launch Toolbar, select the target. When a target has been selected, the 
toolbar looks like in Figure 3-2. Note that the name of the target in the figure, in this case 
Serial @ pc030960, is depending on the name of the computer used. 


Sena@pcs0s0 WCET =) 


Figure 3-2. Tornado Launch Toolbar 


Start the debugger by clicking on the Launch Debugger icon (the insect) on the Tornado 
Launch Toolbar. Iconize its window. 

Hint: Whenever you are in doubt of the action connected to an icon, just keep the mouse 
arrow above the icon (without clicking) and after a while a text box with the icon’s action 
will appear. 


Download the object module mviDemo.o by choosing the menu item: 
Debug -> Download... 


Browse your way to the <disk>:\MVIProtocols\DemoProtocol\work\mviDemo.o file, 
select it, and click on the Download button. 


Debug Code 


17. 


Open the mviDemo.c file in the editor and go to the start of the protHnd!Main function. 
Place the cursor at the first line of that function, and set a breakpoint by clicking on the 
Toggle Breakpoint icon (the filled triangle) on the Tornado Debug Toolbar. 
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18. Now run the Protocol Handler under control from the debugger. Do this by clicking on the 
Run icon (the running man) on the Tornado Debug Toolbar. The Run Task window (see 
Figure 3-3) appears and in it you specify the name of the function you want to start 
(protHndlMain — the starting point of the Protocol Handler), the argument to that function 
(/ — meaning that the Handler will use channel 1), and that you want the debugger to break 
the execution at the entrypoint of the function. 


Run Task AES 


Task name: |nrotHndlMain a 
Arguments fT 


Figure 3-3. Run Task Window 


19. The debugger is now initiated and ready to run the mviDemo Protocol Handler from the 
initial breakpoint. See the Tornado documentation for detailed information about how to 
use the debugger. 


20. Other useful tools when developing with Tornado, are the Shell and the Browser. Just like 
the debugger they are launched from the Tornado Launch Toolbar (see Figure 3-2). See the 
Tornado ducumentation for more information about these tools. 


3.4 Application Procedures 


3.4.1 Protocol Handler Development 


3BSE 015 373R0001 


This is a summary of the steps to take to implement a communication protocol using MVI. 
See Section 3.5, Configuration/Application Building Menus for a detailed description of the 
functions comprising the MVI Runtime Environment. 


Install Tornado. See the Tornado documentation for installation instructions. 


If you are using WinSDE, install it and set it up. See Section 2.2.2.2, WinSDE for installation 
instructions. 


Install and set up MVIBase. See Section 2.2.2.1, MVIBase and User Development Structure for 
installation instructions. This is essential for all steps below.If you already have developed one 
protocol with the MVI Protocol Development Kit 3.0 and now want to develop another, just redo 
the installation but choose another name for your protocol. This will create the needed 
development directories and the menu items in Tornado. 


Generate a PROMed development system (CI538Debug). PROM the system generated and 
install the PROMs on the CI538 module. You need a PROM programmer with support for 
28F020 type Flash PROMs. 
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The steps below correspond to the numbers in Figure 3-4. 


NOTE 
Always do all development (editing, compiling, debugging, and so on) from 
within Tornado. Otherwise all prepared builds, target servers, and so forth, will 
not function. 


1. Create source code 


— Name your Protocol Handler file protocol.c. 


NOTE 


If you do not give the file this name, the prepared compilation command 
(in the Project menu) will not function. 


2. Compile the source code 


— Use the Project menu item: 
UserProtocol: Compile the protocol handler file 


3. Download to target 
— Launch a Target Server and start the debugger before loading. 
4. Debug in target 
— Step your way through the Protocol Handler code. 
5. When satisfied with the Protocol Handler, generate a PROMed production system. 
6. PROM the system generated and install the four PROMs on the CI538 module 
— You need a PROM programmer with support for 28F020 type Flash PROMs. 


NOTE 


This manual does not describe in detail how to use WinSDE tools. For a detailed 
description of WinSDE, refer to the WinSDE documentation. 
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Figure 3-4. Protocol Handler Implementation Steps 
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3.4.1.1 Create Source Code 


Consider the items mentioned in Section 3.1, Design Consideration before you start to 
implement the protocol. That is: 


Should the Protocol Handler be divided into two tasks, Network/Function Handler and 
Data Link Handler? 


Should both master and slave mode be implemented (for master/slave type protocols)? 


Should the Protocol Handler be implemented as a state machine or with a conventional 
multiple handling switch statement? The MVI Demo Protocol is an example of a Protocol 
Handler implemented using the state machine model. 


If you are using WinSDE, take the following steps to be able to put version management on 
your Protocol Handler: 


1s 


2. 


Start WinSDE VersionWorks and choose 
File -> Open Session... 


Choose <disk>:\MVIProtocols\UserProtocol (or the corresponding directory if you have 
chosen another name for your protocol). 


3.4.1.2 Compile the Source Code 
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1. 


From the Project menu, choose: 
UserProtocol: Compile the protocol handler file 


If you have given your protocol another name, the text will be <YourName>: Compile the 
protocol handler file 


Correct any remaining errors using the editor. 
Hint: If you double-click on an error message in the Build window, the source file will be 
opened with the cursor at the erroneous line. 


Repeat steps | and 2 until the object module are correctly built. 


NOTE 


The Makefile and menu entries provided for the Protocol Handler demand that 
the protocol handler is developed in the directories created at installation. They 
also demand that the Protocol Handler file is named protocol.c. 

If you want to do otherwise, you will have to modify the Makefile and the Project 
menu by yourself. 
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3.4.1.3 Download to Target 


Assuming that a MVIBase development system is generated and installed as described in 
Section 4, Debug in Target, take the following steps. 


1. 


3.4.1.4 Debug in Target 


In Tornado, initiate the Target Server connection between the host and target by choosing 
the menu item: 


Tools -> Target Server -> ‘“‘UserProtocol: Debug Target (CI538Debug)”’ 


A window that logs the connection appears. Minimize it. When you want to break the 
connection to the target, you just kill this window and then the Target Server exits. 


From the Tornado Launch Toolbar, select the target. When a target has been selected, the 
toolbar looks like in Figure 3-2 


Start the debugger by clicking on the Launch Debugger icon (the insect) on the Tornado 
Launch Toolbar. Iconize its window. 

Hint: Whenever you are in doubt of the action connected to an icon, just keep the mouse 
arrow above the icon (without clicking) and after a while a text box with the icon’s action 
will appear. 


Download the object module protocol.o by choosing the menu item: 
Debug -> Download... 


Browse your way to the <disk>:\MVIProtocols\UserProtocol\work\protocol.o file, select 
it, and click on the Download button. 


Assuming that the module is downloaded as described in Section 3.4.1.3, Download to Target, 
take the following steps. 


Debug Code 


1. 
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Open the protocol.c file in the editor and go to the start of the protHndIMain function. 
Place the cursor at the first line of that function, and set a breakpoint by clicking on the 
Toggle Breakpoint icon (the filled triangle) on the Tornado Debug Toolbar: 


Now run the Protocol Handler under control from the debugger. Do this by clicking on the 
Run icon (the running man) on the Tornado Debug Toolbar. The Run Task window (see 
Figure 3-3) appears and in it you specify the name of the function you want to start 
(protHndlMain — the starting point of the Protocol Handler), the argument to that function 
(7 — meaning that the Handler will use channel 1), and that you want the debugger to break 
the execution at the entrypoint of the function. 


The debugger is now initiated and ready to run the Protocol Handler from the initial 
breakpoint. See the Tornado documentation for detailed information about how to use the 
debugger. 


Other useful tools when developing with Tornado, are the Shell and the Browser. Just like 
the debugger they are launched from the Tornado Launch Toolbar (see Figure 3-2). See the 
Tornado documentation for more information about these tools. 
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3.4.1.5 Build a Prommed System 


You can build three kinds of MVJBase systems: 
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A debug system — i.e. it has no Protocol Handler in it and only the uppermost port on the 
CI538 board is used for MVI communication. This allows you to attach Tornado to the 
board (via the second port) and download/debug the Protocol Handler. 


A | channel system — i.e. only the uppermost port on the CI538 board is used for MVI 
communication. This allows you to attach Tornado to the board (via the second port) and 
inspect its behavior even when the final system is up and running. This is the 
recommended solution as long as you do not need two MVI channels on the board. 


A 2 channel system — i.e. both ports on the CI538 board are used for MVI communication. 
This removes your possibilities to attach Tornado to the board. 

Therefore it is recommended to use the 1 channel version as long as you do not need 
two MVI channels on the board. 

In reality, there actually is a possibility to access the board even with two MVI channels 
running. Contact ABB if this is absolutely needed. 


Build a Development System 


Assuming that MVIBase is installed as described in Section 2.2.2, Software, take the following 
steps to build a development system. 


1. 


From the Project menu, choose: 
UserProtocol: Build a I channel DEBUG version WITHOUT a protocol (CI538Debug) 


This generates a MVI system load image (C/538Debug) without the Protocol Handler. The 
Handler will be dynamically downloaded later. It also generates a Motorola S-record file 
(CI538Debug.hex) of the load image, which is used by the Flash PROM programmer. Both 
files reside in the <disk>:\MVIProtocols\UserProtocol\work directory. 


Download the S-record file (CI538Debug.hex) to the Flash PROM programmer and make 
the PROMs. 


Install the four Flash PROMs on the CI538 submodule, placed as shown in Figure B-1. 


Install the submodule into the Advant Controller, connect the cable (from the Tornado 
host) to the lower port on the front of the CI538 board, and it is ready for use. 
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Build a Production System 


Assuming that MVIBase is installed as described in Section 2.2.2, Software, take the following 
steps to build a production system. 


1. 


From the Project menu, choose: 

UserProtocol: Build a FINAL, I channel version with the protocol (CI538_1IC) 
or 

UserProtocol: Build a FINAL, 2 channel version with the protocol (CI538_2C 


This generates a MVI system load image (CI538_xC) with the Protocol Handler in it 

(x = 1 or 2). It also generates a Motorola S-record file (CI538_xC.hex) of the load image, 
which is used by the Flash PROM programmer. Both files reside in the 
<disk>:\MV1Protocols\UserProtocol\work directory. 


Download the S-record file (CI538_xC.hex) to the Flash PROM programmer and make the 
PROMS. 


Install the four Flash PROMs on the CI538 submodule, placed as shown in Figure B-1. 


Install the submodule into the Advant Controller, and it is ready to use. 


NOTE 


The core file (the system load image) CI538_xC is necessary when connecting 
Tornado to the CI538 board. So, if a production system is to be 
debugged/inspected with help from Tornado at some point in the future the core 
file must then be present. Therefore it is strongly recommended that a copy of 
the CI538_xC file is saved away for future use. 
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3.4.2 Demo Protocol Application Building for Advant Controller 400 
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This is a summary of the steps necessary to build the application data base and PC program for 
the MVI Demo Protocol in Advant Controller 400. See Appendix A, MVI Demo Protocol 
Configuration for a detailed description of the MVI Demo Protocol application. 


1. 


Answer the questions described in Section 3.1, Design Consideration: 


Network structure 

Line Characteristics 

Function codes to be used for the data transfer 
Register Addresses to be used 


Cycle time for PC program. 


Build the Configuration data base elements: 


MVIMOD data base element (always necessary) 
MVICHAN data base element (always necessary) 
MVINODE data base elements (always necessary) 


Build MVB data base elements for command and data transfer in master mode: 


Read Command data base element 


Write Command data base element. 


Build MVB data base elements for data transfer in slave mode: 


Sending MVB data base element 


Receiving MVB data base element. 


Build PC program for flow control: 


The PC program is only necessary in master mode. 
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PC Program 


Use the PC program to control the MVB data base element if CI538 is used in master mode. 
The PC program is not necessary in slave mode. 


The PC program controls the data flow through the asynchronous port by means of the PC 
element SENDREQ and status information received from the CI538 submodule. The 
SENDREQ element activates the MVB data base element. All SENDREQ PC elements used for 
MVB data base elements to the same PLC must be included in the same control module 
(CONTRM). The PC program is described in Section 3.5.7.6, PC Program Layout. 


Data Base 


The necessary data base input for the CI538 submodule is defined with configuration data base 
elements and data transfer data base elements. 


The data base is divided into two parts: Configuration elements (MVIMOD, MVICHAN and 
MVINODE) and data transfer data base elements (MVB). 


° Configuration data base elements (MVIMOD, MVICHAN and MVINODE) 


MVIMOD data base element is used to set up the two ports on the CI538 submodule, see 
Section 2.2, Setup 


MVICHAN (defines transmission speed, time-out times, etc.), MVINODE represents a 
node on the MVI link (one element for each node), and holds the status information for the 
node. 


° Data transfer data base elements MVB 


Specifies commands and holds data to control slaves when the CI538 is used in master 
mode. Holds data when the CI538 submodule is used in slave mode. 


3-13 


MultiVendor Interface - Protocol Development Kit Advant® Controller 400 Series User’s Guide 
Chapter 3 Configuration/Application Building 


PC Program 


rf + | 


( H/W \ a Configuration DB Elements * (— Data Transfer DB Elements > 


Configuration 


Write Read 
MVIMOD Data Data 
DB Element MVICHAN MVINODE MVB MVB 


Ne 


r 
| 


C1538 


Figure 3-5. Overview of the Application for MVI Demo Protocol 


3.4.2.1 Master Commands 


The commands mentioned below can (in the Demo Protocol) be defined/controlled at 
application level in master mode: 


° Read registers (Command 1) 
Read Command data base element CMDCODE = READ I 
° Write registers (Command 2) 
Write Command data base element CMDCODE = WRITE I 


See Section 3.5.7.3, MVI Data Block Element (MVB) for a description of the Write Command 
MS and of the Read Command MS. 


3.4.2.2 Slave Commands 


It is not necessary to define any commands at application level in slave mode. Only the 
MVICHAN and MVINODE elements and the MVBs for sending and receiving data must be 
defined. 
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3.5 Configuration/Application Building Menus 


This section describes the function libraries comprising the MVI Runtime Environment. It also 
describes the MVI Demo Protocol application. 


3.5.1 MVI UART Interface 


The UART Interface is implemented as a character device driver as defined by the VxWorks I/O 
System. It provides functionality to control the device and handle the data flow to and from the 
device. 


The Protocol Handler manipulates the UART by applying the system calls open, read, write, 
ioctl, select and close on the device name, which represents the instance of the UART in 
question. The VxWorks kernel, in turn, calls the corresponding routine in the device driver 
through the VxWorks I/O System. 


For a description of data structures other than Read Descriptor, Write Descriptor and UART 
interrupt reasons, refer to the include files mviUARTLib.h and mviDRVLib.h, which are part of 
MVIBase. 


3.5.1.1 Read Descriptor and Write Descriptor Data Structures 


The Read Descriptor and Write Descriptor data structures are used, together with the data buff- 
ers, to hold information and data to be transferred between the Protocol Handler and the UART 
device driver. 
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MVI Read Descriptor 


The Protocol Handler initiates a Read Descriptor with information about trigger mode, a pointer 
to the receive buffer, etc., and sends it to the UART device driver by means of a mviReqData 
call. See the fields of the Read Descriptor in Figure 3-6 below. 


typedef enum /* MVI Read Operation Mode */ 

{ 

MviRegard = 1 << 0, /* Regard characters before CC’s */ 

MYyiSoeoceil = i << i, We WwWrevokolsline; @ie CE i = / 

MiyAOComebiesem = I K< 2B, /* OR condition between the CC’s */ 

MvilIdle = 1 << 7 /* Ignore all characters in the receive buffer */ 


} MviReadOperMode; 


struct MviReadDesc 
{ 


1) MviReadOperMode modeOfOperation; /* Mode of Read operation */ 

2) u_int16 maxBufLength; fe Miers leybicicese ileiayejiela ~// 

3) u_int16é postTrigLength; (= Weolsie, (eieske; Cloiavelaliesioynl ~*// 

4) u_int16 noOfReceivedChars; /* No. of received characters. */ 
5) ines ee hoReccenviedee- Pr Wine weSSiac! (el 2 / 

6) u_int8 *readBuffer; /* Read Buffer pointer */ 

7) Sumner COpe, (= CE @awsom ,/ 

8) u_int8 noOfCC; We On Ce Ce %// 

9) u_int8 CCSequence[6]; (these alsa 7, 


} 


Figure 3-6. MVI Read Descriptor Data Structure 


The fields in the MVI Read Descriptor are described below. 
1. Five modes of operation can be defined: 


a. modeOfOperation set to 0 (zero), which means normal operation, that is, all received 
characters are put in the buffer, except for default trig sequence if specified. 


b. |MviRegard, which means that all characters received before the trigger characters 
specified in CCSequence are put in the read buffer. 


c. MviSpecCCl, which means that padding of the first trigger character is enabled. 
When sending a message, each representation of the first trigger character is padded!) 
with another one. When a message is received, and the trigger condition is fulfilled, a 
check is made to see if an odd number of the first trigger character is received. If it is, 
the trigger condition is fulfilled. The padding characters are removed” from the 
received message. This is a way to detect the end of a message represented by a 
combination of two characters, even if the combination may occur within the 
message. This mode implies that noOfCC is set to 2. 


1. The MVI Checksum Library contains a function, mviAddControl, for padding of control characters in a buffer. 
See Section 3.5.3.7, MviAddControl. 

2. The MVI Checksum Library contains a function, mviSkipControl, for removing control characters in a buffer. 
See Section 3.5.3.6, MviSkipControl. 
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d. MviORCondition, which means that there is an OR condition between the trigger 
characters specified, that is, any occurrence of one of the trigger characters in the 
message will fulfill the trigger condition. By default, there is an AND condition 
between the trigger characters specified in that order. 


e. Mvildle, which means that the Read Descriptor does not specify a trigger condition 
for reception of a message. It is just a way of fetching possible events, such as 
character time-outs, and so forth, from the UART. All characters placed in the receive 
buffer before the event occurred are discarded. 


Maximum length of the receive buffer. Maximum length is used by the UART device 
driver when the data buffer is filled. 


This is the number of characters to receive after the CC sequence. Note that the specified 
length of the receive buffer must be large enough to hold both the CC:s and the number of 
characters specified. Relevant only if triggering on message length. 


Number of characters put in the receive buffer, including the CC sequence. This field is 
updated by the UART Interface. 


Updated with the received CC only if there is an OR condition between CC:s in the trigger 
condition. This field is updated by the UART Interface. 


The pointer to the receive buffer. 


The CC Option indicates whether the CC:s should be put in the receive buffer. A zero 
indicates rejection of the CC:s and a one indicates that the CC:s are put in the buffer. 


This is the number of CC:s in the CC sequence. 


The CC sequence, consisting of up to six CC:s. 


MVI Write Descriptor 


The Protocol Handler initiates a Write Descriptor with buffer length and a pointer to the trans- 
mit buffer and sends it to the UART device driver by means of a write() system service. See the 
content of the Write Descriptor in Figure 3-7 below. 


struct MviWriteDesc /* MVI Write descriptor */ 
{ 
(GL_slimie IL) iavolOhEClayeies /* No. of characters to be sent */ 
u_int8 *writeBuffer; /* Pointer to the transmit buffer */ 


}; 


Figure 3-7. MVI Write Descriptor Data Structure 


3.5.1.2 UART Interrupt Reasons 
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The interrupt reason bit field reported from UART Interface contains information about the 
reason for interrupt. It also contains status and error information about the reception/transmis- 
sion and corresponding status/change status for the modem signals. See Figure 3-8. This bit 
field is fetched from UART Interface by means of the ioct] commands 

MviCGetTX WakeupReason and MviCGetRX WakeupReason. 
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typedef enum /* MVI Interrupt reason */ 
{ 

19) MviOverrunError = 1 << 0, /* Overrun error */ 
18) MviParityError = 1 << 1, Ps Weaesieyy Euevaoie ~// 
17) MviFrameError = 1 << 2, JS Wrefenialavey Gueietee ~°/ 
16) MviCharTimeout = 1 << 3, /* Character timeout */ 
15) MviBreakInterrupt = 1 << 4, /* Break interrupt */ 
14) MRVALIDISIR = iL << 5, /* Data Set Ready interrupt */ 
13) MyAlCrS = i << 6, /* Clear To Send interrupt */ 
12) MEALDCD = il << 7, /* Data carrier Detect */ 
11) MviRI = 1 << 8, #f IRaliove Wrevolseeiceue alineGicisbyere =4// 
10) MviCurrDSR = 1 << 9, /* DSR current status */ 
9) NAC ACIS, = il <K 10), /* CTS current status */ 
8) MviCurrDCD = 1 << 11, /* DCD current status */ 
7) MNALCUREERIE = i K< 2, fe IRE (etbheteeiic Seeieuys, »// 
6) MviBufferOverrun = 1 << 14, /* Buffer overrun */ 
5) MviTimerInterrupt = 1 << 23 fee “wsiunese aline@ioiebysye = // 
4) MviRXFailed = 1 << 27, /* Reception failed */ 
3) MviRXCompleted = 1 << 28, /* Reception completed */ 
2) MviTXFailed = 1 << 30, /* Transmission failed */ 
1) MviTXCompleted = 1 << 31 /* Transmission completed */ 


} MviWakeupReason; 


Figure 3-8. UART Interrupt Reasons 
The interrupt reason bit field can be read from the Protocol Handler by means of an ioctl() 
function call. The bits in the UART Interrupt Reason bit field are described below. 
1. TXCompleted: the transmission was completed successfully 
TXFailed: the transmission failed 
RXCompleted: the reception was completed successfully 
RXFailed: the reception failed! 
TimerInterrupt: time-out time has expired 
BufferOverrun: reception buffer overflowed. Buffer too small or speed too high. 
CurrRI: current value of RI (reception) 


CurrDCD: current value of DCD (reception) 


Ber ORE ile FONE I so aos 


CurrCTS: current value of CTS (transmission) 


S 


CurrDSR: current value of DSR (reception) 


— 
— 


RI: status change of RI (reception) 


1 


DCD: status change of DCD (reception) 


= 
~ 


CTS: status change of CTS (transmission) 


= 


DSR: status change of DSR (reception) 


1. The reason for reception failure is given by the bits 6 and 16-19. 
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15. BreakInterrupt: a break sequence received 

16. CharacterTimeout: character timeout has occurred in reception 
17. FramingError: a framing error has occurred in reception 

18. ParityError: a parity error has occurred in reception 


19. OverrunError: an overrun error has occurred in reception. 


NOTE 


RXFailed may be given as walk-up reason, even if the ModeOfOperation in the 
Read Descriptor is set to Mvildle. Consider this during implementation. This is 
applicable when you have a FramingError or a ParityError on received characters. 


3.5.1.3 Open 
NAME 
open - system call 
SYNOPSIS 
int open(char* path, int oflag) 
path, a pointer to a path name naming a file 


oflag, a flag field describing the mode in which the file is opened. The value is constructed 
by OR-ing flags described below: 

O_RDONLY open for reading only 

O_WRONLY open for writing only 

O_RDWR open for reading and writing 

O_NDELAY this flag might affect subsequent reads and writes. 


The files to be included are: 


- ioLib.h 
- mviDrvLib.h 


DESCRIPTION 
The open function initializes a UART device instance. 
RETURNS 


Upon successful completion, the file descriptor is returned. ERROR is returned if a file 
name is not specified, if the device does not exist, if no file descriptor is available, or if the 
driver returns ERROR. If the call fails, errno is set to indicate the error: 
MviEMaxNoDevOpened - max number of devices already opened (Errno: 0x27100006) 
MviEVhiCreateFailed - failed to create an instance of the Primitive Controller 

(Errno: 0x27100007). 

MviEVhiAttachFailed - failed to attach the Primitive Controller to its device 

(Errno: 0x27100008). 
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3.5.1.4 Close 
NAME 
close - system call 
SYNOPSIS 
int close(int filedes) 
filedes, a file descriptor obtained from an open system call 
The files to be included are: 
- ioLib.h 
- mviDrvLib.h 
DESCRIPTION 
The close function releases a UART device instance. 


RETURNS 


The value returned by the driver or ERROR if the file descriptor is invalid. If the call fails, 
errno is set to indicate the error: 

MviEVhiDetachFailed - failed to detach the Primitive Controller from its device 

(Errno: 0x27100009). 

MviEVhiDeleteFailed - failed to delete the instance of the Primitive controller 

(Errno: 0x2710000a). 


3.5.1.5 Read 


The read system call is not used directly in MVI. Instead, use the mviReqData function, 
described in Section 3.5.4.7, MviReqData, to start a read transaction, and use the mviGetData 
function, described in Section 3.5.4.8, MviGetData, to fetch data from the UART. 


3.5.1.6 Write 


The write system call is not used directly in MVI. Instead, use the mviSendData function 
described in Section 3.5.4.9, MviSendData. 
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NAME 
ioctl - system call 
SYNOPSIS 
int ioctl(int filedes, int request, int* arg) 
filedes, a file descriptor obtained from an open system call 
request, the particular command to perform. 
arg, a pointer to an argument associated with the request 
The files to be included are: 


- ioLib.h 
- mviDrvLib.h 
- mviUARTLib.h 


DESCRIPTION 
The ioctl function is used to perform control functions on the UART device. 
RETURNS 


ERROR is returned if the file descriptor does not exist or an error occurs. If the call fails, 
errno is set to indicate the error: 

MviElIllegalCommand - an unsupported command is requested (Errno: 0x2710000e) 
MvikEParamSetFailed - failed to set the value of a parameter (Errno: 0x27100000) 
MviEParamGetFailed - failed to fetch the value of a parameter (Errno: 0x27100001) 
MviEInitFailed - failed to initiate the SCC (Errno: 0x27100002) 

MviEAssertDTRFailed - failed to assert DTR (Errno: 0x27100003) 
MviEDeassertDTRFailed - failed to deassert DTR (Errno: 0x27100004). 


The ioctl() function supports a number of commands as described in Table 3-1. 


Table 3-1. Ioct!l Commands 


Command 


Argument ") Function Performed 


MviCSetParameters 


UART Parameter Block Pointer Sets all parameters defined in the 
parameter block 


MviCGetParameters 


UART Parameter Block Pointer Fetches all parameters defined in the 
parameter block 


MviCSetDuplex Duplex: Sets Duplex mode 

- MviFDuplex 

- MviHDuplex 

- MviHDuplexNoDCD 
MviCSetPreambleTime Number of character times Sets Preamble time 
MviCSetPostambleTime Number of character times Sets Postamble time 
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Command 


Argument ") 


Function Performed 


MviCSetXonXoffHandl 


DxTrue = handle XON/XOFF 
DxFalse = don’t handle XON/XOFF 


Sets XON/XOFF handling mode 


MviCSetBreakHandling 


DxTrue = send break before 
transmission 


DxFalse = Don’t send break before 
transmission 


Sets Break Handling 


MviCSetHalfDupITmo 


Number of character times 


Sets Half Duplex time-out time 


MviCSetBaudrate 


Baudrate: 

- MviB150 

- MviB300 

- MviB600 

- MviB1200 
- MviB2400 
- MviB4800 
- MviB9600 
- MviB19200 
- MviB38400 


Sets Baudrate 


MviCSetParity 


Parity Mode: 

- MviNoParity 

- MviOddParity 

- MviEvenParity 

- MviSpaceParity@) 
- MviMarkParity'?) 


Sets Parity mode 


MviCSetDataBits 


7-bit or 8-bit code: 
- MviSevenDataBits 
- MviEightDataBits 


Sets number of Databits in a character 


MviC SetStopBits 


Number of Stop bits: 

- MviHalfStopBit 

- MviOneStopBit 

- MviOneAndHalfStopBit 
- MviTwoStopBits 


Sets number of Stop bits in a character 


MviCSetCharTimeout 


Number of character times 


Sets the Character Time-out time 


MviC GetDuplex 


A pointer to the variable to which to 
return the value 


Fetches the Duplex mode previously 
set 


MviCGetPreambleTime 


A pointer to the variable to which to 
return the value 


Fetches the Preamble time previously 
set 


MviC GetPostambleTime 


A pointer to the variable to which to 
return the value 


Fetches the Postamble time previously 
set 
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Command Argument “) Function Performed 
MviCGetXonXoffHandl A pointer to the variable to which to | Fetches the XON/XOFF handling 
return the value mode previously set 
MviCGetBreakHandling A pointer to the variable to which to | Fetches the Break handling mode 
return the value previously set 
MviCGetHalfDupITmo A pointer to the variable to which to | Fetches the Half Duplex Time-out time 
return the value previously set 
MviCGetBaudrate A pointer to the variable to which to | Fetches the Baudrate previously set 
return the value 
MviCGetParity A pointer to the variable to which to | Fetches the Parity mode previously set 
return the value 
MviCGetDataBits A pointer to the variable to which to | Fetches the Data Bits code previously 
return the value set 
MviCGetStopBits A pointer to the variable to which to | Fetches the number of Stop bits 
return the value previously set 
MviCGetCharTimeout A pointer to the variable to which to | Fetches the Character Time-out time 
return the value previously set 
MviCInitUART UART Init Descriptor pointer Initiates the UART 
MviCAssertDTR NULL Asserts the Data Terminal Ready 
modem signal 
MviCDeassertDTR NULL Deasserts the Data Terminal Ready 
modem signal 
MviCGetRxWakeupReason UART Interrupt Reason pointer Fetches the reason for waking up in 
select when waiting for read 
completion 
MviCGetTxWakeupReason UART Interrupt Reason pointer Fetches the reason for waking up in 
select when waiting for write 
completion 


(1) The Argument is of type pointer to integer. 


(2) MviSpaceParity is not implemented. 
(3) MviMarkParity is not implemented. 
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NAME 


select - system call 


SYNOPSIS 


struct timeval { long tv_sec; long tv_usec; } 
int select(int nfds, int* readfds, int* writefds, int* exceptfds, struct timeval* timeout) 
nfds, the highest numbered file descriptor that should be checked plus 1 


readfds, a bitmask which represents read file descriptors that should be checked. 
The bitmask is defined according to the formula (1<<fd1)+(1<<fd2)+...... 


writefds, a bitmask which represents write file descriptors that should be checked. 
The bitmask is defined according to the formula (1<<fd1)+(1<<fd2)+...... 


exceptfds, a bitmask which represents exception file descriptors that should be checked. 
The bitmask is defined according to the formula (1<<fd1)+(1<<fd2)+...... 


timeout, a pointer to a timeval struct specifying a timeout value for select(). This value is 
used by the select() system call to return after a certain amount of time, even if I/O has not 
been performed 


The files to be included are: 


- ioLib.h 
- selectLib.h 
- mviDrvLib.h 


DESCRIPTION 


The select() system call allows a process to check if one or more devices is capable of 
doing I/O. If none of the requested devices are ready, the system blocks the process until 
one (or several) becomes ready. 


RETURNS 


Upon successful completion, the number of file descriptors ready for I/O is returned, and 
the bitmasks are modified to indicate which file descriptor(s) are ready. If the time-out 
time expires, select() returns OK and all masks are cleared. Otherwise select() returns 
ERROR and errno contains the reason for the error. 
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EXAMPLE 


void example_of_select (void) 


int width; 

fd_set readFds, writeFds, 

int fdl, fd2; 

MviReadDesc readDesc; 

MviWriteDesc writeDesc 

MviWakeupReason wakeupReason; 

fdl = open(...); fd2 = open(...); 

width = (fdl > fd2) ? fdl : fd2; widtht+; 


mviReqData( fdl, &readDesc ); 
FD_ZERO( é&readFds ); FD_SET( fdl, &readFds ); 
select (width, &readFds, NULL, NULL, NULL); 
if (FD_ISSET (fdl1, &readFds) ) 
{ 
ioctl(fdl, MviCGetRxWakeupReason, wakeupReason) ; 
if (wakeupReason & MviRXCompleted) 
{ 
/* mviSendData() succeded */ 
mviGetData(fdl, é&readDesc) 
writeDesc.writeBuffer = readDesc.readBuffer; 
writeDesc.noOfChar = readDesc.noOfReceivedChars; 
mviSendData( fd2, &writeDesc); 
FD_ZERO( &writeFds ); FD_SET( fd2, &writeFds ); 
select (width, NULL, &writeFds, NULL, NULL); 
if (FD_ISSET(fd2, &writeFds) ) 
{ 
ioctl(fd2, MviCGetTxWakeupReason, wakeupReason) ; 
if (wakeupReason & MviTXCompleted) 
{ 
/* mviSendData() succeded */ 
} 
else 
{ 
/* mviSendData() failed */ 
} 


r 


} 


else 


{ 
/* mviReqData() failed */ 
} 
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3.5.2.1 Open 
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The MVI Watchdog Timer function is implemented as a character device driver as defined by 
the VxWorks I/O System. It provides a set of functions to control the device. This device driver 
encapsulates the VxWorks Watchdog Timer function, making it possible to wait for a Watchdog 
Timer to expire in select. 


A Watchdog Timer can be opened using the open() system call, closed using the close() system 
call, waited for using the select() system call and manipulated using the ioctl() system call. 
The ioctl commands supported are as follows. 


° MviCWDrTsStart: start the Watchdog Timer. The ioctl argument should contain the delay 
time in number of milliseconds. 


° MviCWDTCancel: cancel a running Watchdog Timer. The ioctl argument is ignored by 
this command. 


Since the VxWorks implementation of select does not support the exception mask, the read 
mask is used instead. To be able to wait in select for a Watchdog Timer to expire, the timer 
device file descriptor should be set in the read mask of the select call. 


NOTE 


If a Watchdog Timer has expired, and it is not restarted afterwards, it must be 
cancelled if the timer device file descriptor is kept in the select mask. Otherwise 
the next call to select() will immediately wake up the calling task, without having 
received a new Watchdog Timer event. 


NAME 
open - system call 
SYNOPSIS 
int open(char* path, int oflag) 
path, a pointer to a path name naming a file 


oflag, a flag field describing the mode in which the file is opened. The value is constructed 
by OR-ing flags described below: 

O_RDONLY open for reading only 

O_WRONLY open for writing only, O_RDWR open for reading and writing 
O_NDELAY this flag might affect subsequent reads and writes 


The files to be included are: 


- ioLib.h 
- mviDrvLib.h 


DESCRIPTION 
The open function initializes a Watchdog Timer device instance. 
RETURNS 


Upon successful completion, the file descriptor is returned. ERROR is returned if a file 
name is not specified, if the device does not exist, if no file descriptors are available or if 
the driver returns ERROR. If the call fails, errno is set to indicate the error: 
MviEMaxNoDevOpened - max number of devices already opened (Errno: 0x27100006) 
MviEWDCreateFailed - creating a Watchdog Timer failed. 
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3.5.2.2 Close 
NAME 
close - system call 
SYNOPSIS 
int close(int filedes) 
filedes, a file descriptor obtained from an open system call 
The files to be included are: 


- ioLib.h 
- mviDrvLib.h 


DESCRIPTION 
The close function releases a Watchdog Timer device instance. 
RETURNS 


The value returned by the driver, or ERROR if the file descriptor is invalid. If the call fails, 
erro is set to indicate the error: 
MviEWDDeleteFailed - failed to delete the Watchdog Timer. 


3.5.2.3 loctl 
NAME 
ioctl - system call 
SYNOPSIS 
int ioctl(int filedes, int request, int* arg) 
filedes, a file descriptor obtained from an open system call 
request, the particular command to perform. 
arg, a pointer to an argument associated with the request 
The files to be included are: 


- ioLib.h 
- mviDrvLib.h 


DESCRIPTION 


The ioctl function is used to perform control functions on the Watchdog Timer device. 
The functions supported are: 


—-  MviCWwDrTStart. Start the Watchdog Timer. The ioctl argument should contain the 
delay time in number of milliseconds. 


—  MviCWDTCancel. Cancel a running Watchdog Timer. The ioctl argument is ignored 
by this command. 


RETURNS 


ERROR is returned if the file descriptor does not exist or an error has occurred. If the call 
fails, errno is set to indicate the error: 
MviEllegalCommand - an unsupported command is requested (Errno: 0x2710000e). 
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NAME 
select - system call 
SYNOPSIS 
struct timeval { long tv_sec; long tv_usec; } 
int select(int nfds, int* readfds, int* writefds, int* exceptfds, struct timeval* timeout) 
nfds, the highest numbered file descriptor that should be checked plus 1 


readfds, a bitmask which represents read file descriptors that should be checked. 
The bitmask is defined according to the formula (1<<fd1)+(1<<fd2)+...... 


writefds, a bitmask which represents write file descriptors that should be checked. The bit 
mask is defined according to the formula (1<<fd1)+(1<<fd2)+...... 


exceptfds, a bitmask which represents exception file descriptors that should be checked. 
The bitmask is defined according to the formula (1<<fd1)+(1<<fd2)+...... 


timeout, a pointer to a timeval struct specifying a timeout value for select(). This value is 
used by the select() system call to return after a certain amount of time, even if I/O has not 
been performed. 


The files to be included are: 


- ioLib.h 
- selectLib.h 
- mviDrvLib.h 


DESCRIPTION 


The select() system call allows a process to check if one or more devices are capable of 
doing I/O. If none of the requested devices are ready, the system blocks the process until 
one (or several) becomes ready. 


RETURNS 


Upon successful completion, the number of file descriptors ready for I/O is returned, and 
the bitmasks are modified to indicate which file descriptor(s) are ready. If the time-out 
time expires, select() returns OK and all masks are cleared. Otherwise, select() returns 
ERROR and errno contains the reason for the error. 


EXAMPLE: 
void example_of_select (void) 
{ 
int width; 


fd_set readFds, writeFds, 

int. fdil.,£d2;. £434 

int wdTime = 100; /* Timeout time in milliseconds */ 
MviReadDesc readDesc; 

MviWriteDesc writeDesc 
MviWakeupReason wakeupReason; 
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fdl = open(“mviUART/1, ...”); £ 
fd3 = open(“/watchdogTimer/1”,. 
width = (fdl > fd2) ? fdl : fd2 


mviReqData( fdl, &readDesc ); 
ioctl(fd3, MviCWDTStart, &wdTim 
FD_ZERO( &readFds ); FD_SET( fd 
FD_SET( £d3, &readFds ); 
select (width, &readFds, NULL, N 
if (FD_ISSET (fdl1, &readFds) ) 

{ 

/* Event from UART */ 


d2 = open(“mviUART/2”, ...); 


-e)e 
; width++; 


e); 
1, &readFds ); 


ULL, NULL); 


ioctl(fdl, MviCGetRxWakeupReason, wakeupReason) ; 
if (wakeupReason & MviRXCompleted) 


{ 


/* mviSendData() succeded */ 


mviGetData(fdl, é&readDesc) 


writeDesc.writeBuffer = readDesc.readBuffer; 


writeDesc.noOfChar = readDesc.noOfReceivedChars; 
mviSendData( fd2, &writeDesc); 


FD_ZERO( &writeFds ); FD_S 


r 


ET( £fd2, &writeFds ); 


select (width, NULL, &writeFds, NULL, NULL); 


if (FD_ISSET (fd2, &éwriteFds 


{ 
ioctl (fd3, MviCWDTCancel 


)) 


, O)3 


ioctl(fd2, MviCGetTxWakeupReason, wakeupReason) ; 
if (wakeupReason & MviTXCompleted) 


{ 


/* mviSendData() succeded */ 


} 


else 


{ 


/* mviSendData() failed */ 


} 


} 


else 


{ 
/* mviReqData() failed */ 


/* Event from watchdog Timer 


(Watchdog Timer expired) */ 
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3.5.3 MVI Checksum Library 


This section describes functions for checksum calculations and related services supported by the 
MVI Runtime Environment. The functions supported are as follows: 


3.5.3.1 MviCrce_16 


3-30 


mviCrc_16: CRC-16 checksum calculation. 

mviBcc: BCC checksum calculation. 

mviLrce: LRC checksum calculation. 

mviCrc_8: CRC-8 checksum calculation. 

mviSum: Arithmetic sum checksum calculation. 
mviSkipControl: Takes away control characters from a buffer. 


mviAddControl: Adds a control character after another in a buffer. 


NAME 


mviCrc_16 - calculates the CRC-16 value for a data buffer 


SYNOPSIS 


u_intl6 mviCrc_16 (u_int8 buffer, int length, u_int16 poly, int version, u_int16 accSet) 


buffer, a pointer to the buffer where the message is stored for which the checksum is to be 
calculated 


length, the length of the message (bytes) 
poly, the crc-polynom 
version, calculation method (1 = normal, 2 = reversed) 


accSet, the value that the accumulator will get before the crc calculation starts 


The files to be included are: 


- mviChkSumLib.h 


DESCRIPTION 


The function calculates the CRC-16 value for a data buffer. The calculation method used is 
either normal or reversed, depending on the version parameter. The polynom used in the 
calculation is chosen by the user with the poly parameter. 


NOTE 


When you are using the reversed calculation method, you must byte-swap the 
returned CRC-value before it is transmitted. 
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EXAMPLE 


An example of how the CRC-16 checksum is calculated using version=1 (reversed 
calculation) and Oxffff as accumulator preset follows. The polynom used is 
10100000000000101. After the accumulator is loaded with the accumulator preset, 
the step-by-step procedure to form the CRC-value is as follows: 


1. Shift the data byte and the accumulator one step to the right. 


2a. If the bit shifted out from the data byte exclusive-OR’ed with the bit shifted out from 
the accumulator is 1 (one), then the accumulator should be exclusive-OR’ed with the 
polynom. 


2b. If the bit shifted out from the data byte exclusive-OR’ed with the bit shifted out from 
the accumulator is 0 (zero), then return to step 1. 


3. Repeat | and 2 until eight shifts have been performed. 

4. Fetch new data byte. 

5. Repeat steps 1 - 4 until all bytes of the message have been used. 
Message = {0x02, 0x07} 


Data 0000 0010 (0x02) 
Acc LTD: SED. ACT Pede «ee 
Shift 1 Data 0000 0001 —> 0 
Acc OAD AAT Te al =—> 1 
Poly 1010 0000 0000 0001 
1101 1111 1111 1110 
Shift 2 Data 0 0000 —-> 1 
Acc O11 0 AVAL eT aD —> 0 
Poly 1010 0000 0000 0001 
1100 1111 1111 1110 
Shift 3 Data 0 000 —> 0 
Acc O110" O27. eT Ia a —> 0 
Shift 4 Data 0000 0000 —> 0 
Acc 0011 0011 1111 1111 —> 1 
Poly 1010 0000 0000 0001 
1001 0011 1111 111 
Shift 5 Data 0000 0000 —> 0 
Acc 0100 1001 1111 1111 —> 0 
Shift 6 Data 0000 000 —> 0 
Acc 0010 0100 1111 1111 =—> 1 
Poly 1010 0000 0000 0001 
1000 0100 1111 1110 
Shift 7 Data 0000 000 —> 0 
Acc 0100 0010 0111 1111 -> 0 
Shift 8 Data 0000 0000 —> 0 
Acc 0010 0001 0011 1111 ->1 
Poly 1010 0000 0000 0001 
1000 0001 0011 1110 
Data 0000 0111 (0x07) 
Acc 1000 0001 0011 1110 
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Shift 1 


Shift 2 


Shift 3 


Shift 4 


Shift 5 


Shift 6 


Shift 7 


Shift 8 


Data 
Acc 
Poly 


Data 
Acc 
Poly 


Data 
Acc 
Poly 


Data 
Acc 
Data 
Acc 
Poly 


Data 
Acc 
Data 
Acc 
Data 
Acc 


Checksum 


0011 
1010 
1001 


0100 


0010 


0001 
1 


0000 
0000 
0000 


0000 
0000 
0000 
1000 
0000 
1000 
0100 
0010 
0000 
0010 
1001 
0100 


0010 
2 


0x1241 


0000 0011 —-> 1 


1001 1111 -> 0 
0000 0001 
1001 1110 
0000 0001 —-> 1 
0100 1111 -> 0 
0000 0001 
0100 1110 
0000 0000 —-> 1 
0010 0111 -> 0 
0000 0001 
0010 0110 
0000 0000 —> 0 
0001 0011 -> 0 
0000 0000 -—> 0 
0000 1001 -> 1 
0000 0001 
0000 1000 
0000 0000 —> 0 
0000 0100 


0000 0000 -> 
1000 0010 -> 

0000 0000 -> 
0100 0001 -> 
4 1 


ooo °o 


Another example of how CRC-16 checksum is calculated, this time using version = | 
(normal calculation) and 0x0000 as accumulator preset, follows. The polynom used is 
1000000000000101. The step-by-step procedure to form the CRC-value is as follows: 


1. Shift the data byte and the accumulator one step to the left. 


2a. If the bit shifted out from the data byte exclusive-OR’ed with the bit shifted out from 
the accumulator is | (one), then the accumulator should be exclusive-OR’ed with the 


polynom. 


2b. If the bit shifted out from the data byte exclusive-OR’ed with the bit shifted out from 
the accumulator is 0 (zero), then return to step 1. 


3. Repeat 1 and 2 until eight shifts have been performed. 


4. Fetch new data byte. 


5. Repeat steps 1 - 4 until all bytes of the message have been used. 


Message = {0x02, 0x07} 


Shift 1 


Shift 2 


Data 
Data 
Acc 
Data 
Acc 


ooo °o 


0000 
0000 
0000 
0000 
0000 


0010 
0100 
0000 0000 0000 
1000 
0000 0000 0000 
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Shift 3 Data Q <- 0001 0000 
Acc Q <- 0000 0000 0000 0000 
Shift 4 Data Q <- 0010 0000 
Acc Q <- 0000 0000 0000 0000 
Shift 5 Data Q <- 0100 0000 
Acc Q <- 0000 0000 0000 0000 
Shift 6 Data OQ <- 1000 0000 
Acc Q <- 0000 0000 0000 0000 
Shift 7 Data 1 <- 0000 0000 
Acc Q <- 0000 0000 0000 0000 
Poly 1000 0000 0000 0101 
1000 0000 0000 0101 
Shift 8 Data Q <- 0000 0000 
Acc 1 <- 0000 0000 0000 1010 
Poly 1000 0000 0000 0101 
1000 0000 0000 1111 
Data 0000 0111 
Acc 1000 0000 0000 1111 
Shift 1 Data Q <- 0000 1110 
Acc 1 <- 0000 0000 0001 1110 
Poly 1000 0000 0000 0101 
1000 0000 0001 1011 
Shift 2 Data Q <- 0001 1100 
Acc 1 <- 0000 0000 0011 0110 
Poly 1000 0000 0000 0101 
1000 0000 0011 0011 
Shift 3 Data Q <- 0011 1000 
Acc 1. <- 0000 0000 0110 0110 
Poly 1000 0000 0000 0101 
1000 0000 0110 0011 
Shift 4 Data Q <- 0111 0000 
Acc 1 <- 0000 0000 1100 0110 
Poly 1000 0000 0000 0101 
1000 0000 1100 0011 
Shift 5 Data Q <- 1110 0000 
Acc 1, 0000 0001 1000 0110 
Poly 1000 0000 0000 0101 
1000 0001 1000 0011 
Shift 6 Data 1 <- 1100 0000 
Acc 1 <- 0000 0011 0000 0110 
Shift 7 Data 1 <- 1000 0000 
Acc Q <- 0000 0110 0000 1100 
Poly 1000 0000 0000 0101 
1000 0110 0000 1001 
Shift 8 Data 1 <- 0000 0000 
Acc 1 <- 0000 1100 0001 0010 
Hex 0 c dl: 2 


Checksum = 0x0c12 
RETURNS 
The calculated CRC-value. 
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NAME 

mviBcc - calculates the BCC checksum for a data buffer 
SYNOPSIS 

u_int8 mviBcc (u_int8 buffer, int length) 


buffer, a pointer to the buffer where the message is stored for which the checksum is to be 
calculated 


length, the length of the message (bytes) 
The files to be included are: 

- mviChkSumLib.h 
DESCRIPTION 

The function calculates the BCC checksum for a data buffer. 
EXAMPLE 


An example of how the BCC-value is calculated using {0x02, 0x07} as input follows. 
The step-by-step procedure to form the BCC-checksum is as follows: 


1. Exclusive OR the data byte with the accumulator. 
2. Fetch new data byte. 


3. Repeat | and 2 until all bytes of the message are used. 


Data 0000 0010 
Acc 0000 0000 
0000 0010 
Data 0000 0111 
Acc 0000 0010 
0000 0101 
Hex 0 5 


Checksum = 0x05 


RETURNS 
The calculated BCC-value. 
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mviLrc - calculates the LRC checksum for a data buffer 


SYNOPSIS 


u_int8 mviLrc (u_int8 buffer, int length) 


buffer, a pointer to the buffer where the message is stored for which the checksum is to 


be calculated 


length, the length of the message (bytes) 


The files to be included are: 


- mviChkSumLib.h 
DESCRIPTION 


The function calculates the LRC checksum for a data buffer. 


EXAMPLE: 


An example of how the LRC-value is calculated using {0x02, 0x07} as input follows. 
The step-by-step procedure to form the LRC-checksum is as follows. 


1. Add data byte to accumulator without wraparound carry. 


2. Fetch new data byte. 


3. Repeat | and 2 until all bytes of the message have been used. 


4. Invert accumulator and add 1. 


Data 0000 0010 
Acc 0000 0000 
0000 0010 
Data 0000 0111 
Acc 0000 0010 
0000 1001 
Invert 1111 0110 
Add 11111 0111 
Hex £ 7 


Checksum = Oxf7 


RETURNS 


The calculated LRC-value. 
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3.5.3.4 MviCrc_8 
NAME 
mviCrc_8 - calculates the CRC-8 value for a data buffer 
SYNOPSIS 
u_int8 mviCrc_8 (u_int8 buffer, int length, u_int8 poly, int version, u_int8 accSet) 


buffer, a pointer to the buffer where the message is stored for which the checksum is to 
be calculated 


length, the length of the message (bytes) 

poly, the crc-polynom 

version, calculation method (1 = normal, 2 = reversed) 

accSet, the value that the accumulator gets before the CRC calculation starts. 
The files to be included are: 

- mviChkSumLib.h 
DESCRIPTION 


The function calculates the CRC-8 value for a data buffer. The calculation method used is 
either normal or reversed, depending on the version parameter. The polynom used in the 
calculation is chosen by the user with the poly parameter. 


RETURNS 
The calculated CRC-value. 


3.5.3.5 MviSum 
NAME 
mviSum - calculates the arithmetic checksum for a data buffer 
SYNOPSIS 
u_int8 mviSum (u_int8 buffer, int length) 


buffer, a pointer to the buffer where the message is stored for which the checksum is to 
be calculated 


length, the length of the message (bytes) 
The files to be included are: 

- mviChkSumLib.h 
DESCRIPTION 


The function calculates the arithmetic checksum for a data buffer. The message bytes are 
added using no carry. 
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EXAMPLE 


An example of how the SUM-value is calculated using {0x02, 0x07} as input follows. 
The step-by-step procedure to form the arithmetic-checksum is as follows: 


1. Add the data byte to the accumulator without wraparound carry. 
2. Fetch new data byte. 


3. Repeat | and 2 until all bytes of the message have been used. 


Data 0000 0010 
Acc 0000 0000 

0000 0010 
Data 0000 0111 
Acc 0000 0010 

0000 1001 
Hex 6) 9 
Checksum = 0x09 

RETURNS 


The calculated SUM-value. 


3.5.3.6 MviSkipControl 
NAME 


mviSkipControl - search for and delete all control characters or every other control 
character mentioned 


SYNOPSIS 


int mviSkipControl(u_int8 charToDelete, u_int8 bufferIn, int length, 
u_int8 bufferOut, int version) 


charToDelete, control character to be deleted 

bufferIn, a pointer to the buffer where the message is stored 

length, the length of the message (bytes) 

bufferOut, a pointer to the buffer where the modified message is placed 

version, | = remove all char, 2 = remove every second char 
The files to be included are: 

- mviChkSumLib.h 
DESCRIPTION 

Search for and delete all control characters or every other control character mentioned. 
RETURNS 


The length of the modified message. 
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3.5.3.7 MviAddControl 


NAME 
mviAddControl - search for a control character and adds another 
SYNOPSIS 


int mviAddControl (u_int8 charToFind, uint_8 charToAdd, u_int8* bufferIn, 
int length, u_int8* bufferOut, int version) 


charToFind, control character to search for 

charToAdd, control character to add 

bufferIn, a pointer to the buffer where the message is stored 

length, the length of the message (bytes) 

bufferOut, a pointer to the buffer where the modified message is placed 

version | = Add the specified control character before the control character searched for 

2 = Add the specified control character after the control character searched for 

The files to be included are: 

- mviChkSumLib.h 
DESCRIPTION 


Searches for a control character and adds another, after or before, the mentioned control 
character 


RETURNS 


The length of the modified message or MviBufSize if bufferOut is too small for modified 
message. 


3.5.4 MVI Runtime Library 


3-38 


This section describes functions for allocation, initialization, manipulation and deallocation of 
MVI Runtime Environment data structures. The functions supported are: 


° mviGetNodeDLEntry - Get the DL-entry for a given node 

° mviGetNodeStatusInfo - Get status information for a given node 

° mviGetNodeDiagInfo - Get diagnostic information for a given node 

° mvilnitUART - Initiate UART device 

° mviCreateUARTDevice - Create UART device for the instance spawned 
° mviOpenUARTDevice - Open UART device for the instance spawned 

° mviReqData - Sends the Read Descriptor to the UART device 

° mviGetData - Fetches data from the UART device 

° mviSendData - Sends data through the UART device 

° mviSelect - Waits on a number of file descriptors for an event to occur 


° mviSendLinkStatus - Setting up or taking down a connection between the application 
and a RTU on the communication link 


° mviCreatePHIDevices - Create Protocol Handler Interface devices 


° mviCreateDLIDevices - Create Data Link Handler Interface devices 
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° mviOpenPHIDevices - Open Protocol Handler Interface devices 

° mviOpenDLIDevices - Open Data Link Handler interface 

° mviCreateTimerDevices - Create Watchdog Timer devices 

° mviOpenTimerDevices - Open Watchdog Timer devices 

° mviFetchSetupInfo - Fetch initialization information from application 

° mvilnitDLStruct - Initialize the DL structure 

° mvilnitGlobalDataStruct - Initializes the common part of the GlobalData structure 
° mviMakeWDTDevName - Creates a device name string for Watchdog Timer devices 
° mviCleanup - Deallocates data structures and closes devices opened 

° mviSendDLSetupInfo - Send setup info 

° mviFetchDLSetupInfo - Receive setup info 

° mviWaitForModemSignals - Waits for modem signals to become active 

° mviSysMess - Send a system message 


For descriptions of data structures, refer to the include file mviDLLib.h, which is part of 
MVIBase. 


3.5.4.1  MviGetNodeDLEntry 
NAME 
mviGetNodeDLEntry - get the DL-entry for a given node 
SYNOPSIS 


MviStatus mviGetNodeDLEntry(MviDL* dlPtr, u_int8 nodeNo, 
MviDLEntry **dlEntryPtr) 


diPtr, a pointer to the DL data structure 

nodeNo, node number 

dlEntryPtr, a pointer to a pointer to a MviDLEntry struct 
The files to be included are: 

- mviDLLib.h 
DESCRIPTION 


This function searches the DL-struct for a DL-entry corresponding to a given node 
number. The pointer to the DL-entry found is then copied to the pointer to a 
MviDIEntry struct. 


RETURNS 


MviOk or, if the operation fails, MviError. 


3BSE 015 373R0001 3-39 


MultiVendor Interface - Protocol Development Kit Advant® Controller 400 Series User’s Guide 
Chapter 3 Configuration/Application Building 


3.5.4.2 MviGetNodeStatusInfo 
NAME 
mviGetNodeStatusInfo - get status information for a given node 
SYNOPSIS 


MviStatus mviGetNodeStatusInfo(MviDL* dlPtr, u_int8 nodeNo, 
MviNodeStat **nodeStatPtr) 


dlPtr, a pointer to the DL data structure 

nodeNo, node number 

nodeStatPtr, a pointer to a pointer to a MviNodeStat struct 
The files to be included are: 

- mviDLLib.h 
DESCRIPTION 


This function searches the status information struct for a node status entry corresponding 
to a given node number. The pointer to the node status entry found is then copied to the 
pointer to a MviNodeStat struct. 


RETURNS 


MviOk or, if the operation fails, MviError. 


3.5.4.3 MviGetNodeDiagInfo 
NAME 
mviGetNodeDiagInfo - get diagnostic information for a given node 
SYNOPSIS 


MviStatus mviGetNodeDiagInfo(MviDL* dlPtr, u_int8 nodeNo, 
MviNodeDiag **nodeDiagPtr) 


dlPtr, a pointer to the DL data structure 

nodeNo, node number 

nodeDiagPtr, a pointer to a pointer to a MviNodeDiag struct 
The files to be included are: 

- mviDLLib.h 
DESCRIPTION 


This function searches the diagnostic information struct for a node diagnostic entry 
corresponding to a given node number. The pointer to the node diagnostic entry found is 
then copied to the pointer to a MviNodeDiag struct. 


RETURNS 


MviOk or, if the operation fails, MviError. 
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3.5.4.4 MvilnitUART 
NAME 
mvilnitUART - initiate UART device 
SYNOPSIS 


MviStatus mvilInitUART(int fileDesc, 

MviProtSetupInfo* setupDataPtr, 
MviUARTParBlk* parameterBlockPtr, 
MvilnitDescriptor* initDescriptorPtr, 
MviHandleXonXoff xonXoff, 
MviSendBreak sendBreak, 
DxBoolean ringIndIrq, 

DxBoolean breakIrq) 


fileDesc, file descriptor for the UART device 
setupDataPtr, a pointer to the setup data structure 
parameterBlockPtr, a pointer to the UART parameter data structure 
initDescriptorPtr, a pointer to the UART init descriptor data structure 
xonXoff defines whether xon/xoff is handled 
- DxTrue = xon/xoff is handled 
sendBreak defines whether a break character is sent before transmission 
- DxTrue = break is sent before transmission 
ringIndIrq defines whether an interrupt is generated upon a status change of RI 
- DxTrue = interrupt is generated 
breakIrq defines whether an interrupt is generated upon reception of a break character 
- DxTrue = interrupt is generated 
The files to be included are: 
- mviDLLib.h 
DESCRIPTION 


This function is used by the Protocol Handler to make a full initialization of the UART 
device. It assumes that the setupDataPtr is initialized. 


RETURNS 


MviOk or, if the operation fails, MviError. 
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3.5.4.5 MviCreateUARTDevice 
NAME 
mviCreateUARTDevice - create UART device for the instance spawned 
SYNOPSIS 
MviStatus mviCreateUARTDevice(int taskInstance) 
taskInstance, instance number of the task spawned. Instances are numbered | - n. 
The files to be included are: 
- mviDLLib.h 
DESCRIPTION 
This function creates the UART devices used in MVI. 
RETURNS 


MviOk or, if the operation fails, MviError. 


3.5.4.6 MviOpenUARTDevice 
NAME 
mviOpenUARTDevice - open UART device for the instance spawned 
SYNOPSIS 
MviStatus mviOpenUARTDevice(int* uartFdPtr, int taskInstance) 
uartFdPtr, a pointer to the UART file descriptor 
taskInstance, instance number of the task spawned. Instances are numbered | - n. 
The files to be included are: 
- mviDLLib.h 
DESCRIPTION 


This function opens the UART device which is to be used by the Protocol Handler 
instance. 


RETURNS 


MviOk or, if the operation fails, MviError. 


3.5.4.7 MviReqData 
NAME 
mviReqData - sends the Read Descriptor to the UART device 
SYNOPSIS 
mviReqData(int fd, MviReadDesc *readDesc) 
fd, file descriptor to device 


readDesc, a pointer to the Read Descriptor which is to be used by the UART device. 
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The files to be included are: 

- mviDLLib.h 
DESCRIPTION 

Sends the Read Descriptor to the UART device. 
RETURNS 


0 if successful, -1 if error. 


NAME 

mviGetData - fetches data from the UART device 
SYNOPSIS 

mviGetData(int fd, MviReadDesc *readDesc) 

fd, file descriptor to device 

readDesc, a pointer to the Read Descriptor. 
The files to be included are: 

- mviDLLib.h 
DESCRIPTION 

Gets the data from the UART device. 
RETURNS 


The number of received characters, -1 if error. 


NAME 

mviSendData - sends data through the UART device 
SYNOPSIS 

mviSendData(int fd,MviWriteDesc *writeDesc) 

fd, file descriptor to device 

writeDesc, a pointer to the Write Descriptor 
The files to be included are: 

- mviDLLib.h 
DESCRIPTION 

Sends the data through the UART device. 
RETURNS 


-1 if error. 
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3.5.4.10 MviSelect 
NAME 
mviSelect - waits on a number of file descriptors for an event to occur 
SYNOPSIS 

int mviSelect(int nfds, 
MviFdSet* readMask, 
MviFdSet* writeMask, 
int watchdogToutFd, 
int watchdogFd, 
DxBoolean selectBlocked) 

nfds, number of file descriptors 

readMask, a pointer to the read mask or NULL 

writeMask, a pointer to the write mask or NULL 

watchdogToutFd, file descriptor for Watchdog timeout timer 

watchdogF4d, file descriptor for Watchdog message 

selectBlocked, defines whether to wait in select until an event occurs 

-DxTrue = wait for event 
The files to be included are: 
- mviDLLib.h 
DESCRIPTION 


Besides making a select call, this function hides the sending of Watchdog messages to the 
Host System. 


RETURNS 


The number of file descriptors which are ready for I/O if the call succeeds, otherwise 
ERROR. If the call succeeds, the bitmasks are modified to indicate which file descriptors 
are ready. If the timeout time expires, OK is returned and all masks are cleared. 


EXAMPLE 


void example_of_select (void) 


int width; 

fd_set readFds, writeFds, 

int fdl, fd2, wdToutFd, wdFd; 
MviReadDesc readDesc; 
MviWriteDesc writeDesc 
MviWakeupReason wakeupReason; 
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fdl = open(...); fd2 = open(...); 
wdToutFd = open(...); wdFd = open(...); 
width = (fdl > fd2) ? fdl : fd2; width++; 


mviReqData( fdl, &readDesc ); 
FD_ZERO( é&readFds ); FD_SET( fdl, &readFds ); 
mviSelect (width, &readFds, NULL, wdToutFd, wdFd, DxTrue); 
if (FD_ISSET(fdl1,&readFds) ) 
{ 
ioctl (fdl, MviCGetRxWakeupReason, wakeupReason) ; 
if (wakeupReason & MviRXCompleted) 
{ 
/* mviSendData() succeded */ 
mviGetData(fdl, é&readDesc) 
writeDesc.writeBuffer = readDesc.readBuffer; 
writeDesc.noOfChar = readDesc.noOfReceivedChars; 
mviSendData( fd2, &writeDesc); 
FD_ZERO( &writeFds ); FD_SET( fd2, &writeFds ); 
mviSelect (width, NULL, &writeFds, 
wdToutFd, wdFd, DxTrue); 
if (FD_ISSET (fd2, &éwriteFds) ) 
{ 
ioctl (fd2, MviCGetTxWakeupReason, wakeupReason) ; 
if (wakeupReason & MviTXCompleted) 
{ 
/* mviSendData() succeded */ 
} 
else 
{ 
/* mviSendData() failed */ 
} 


} 
else 
{ 
/* mviReqData() failed */ 
} 
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3.5.4.11 MviSendLinkStatus 
NAME 
mviSendLinkStatus - setting up or taking down a connection 
SYNOPSIS 


MviStatus mviSendLinkStatus(MviDL* dIPtr, MviGlobalData* globalDataPtr, 
MviLinkStatus newLinkStatus 


diPtr, a pointer to the MviDL data structure 

globalDataPtr, a pointer to the MviGlobalData structure 

newLinkStatus defines whether to send connect or disconnect command 
The files to be included are: 

- mviDLLib.h 
DESCRIPTION 


This routine sends a node connect or a node disconnect command to the Host Interface and 
waits for a response. It also updates linkStatus for the corresponding dlEntry/dlEntries 


accordingly. 
NOTE 
There is no time-out in select when waiting for the response from the Host 
Interface. 
RETURNS 


MviOk or, if the operation fails, MviError. 


3.5.4.12 MviCreatePHIDevices 
NAME 
mviCreatePHIDevices - create Protocol Handler Interface devices 
SYNOPSIS 
MviStatus mviCreatePHIDevices(void) 
The files to be included are: 
- mviDLLib.h 
DESCRIPTION 
This function creates the FIFO devices which are part of the Protocol Handler Interface. 
RETURNS 


MviOk or, if the operation fails, MviError. 
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3.5.4.13 MviCreateDLIDevices 
NAME 
mviCreateDLIDevices - create Data Link Handler Interface devices 
SYNOPSIS 
MviStatus mviCreateDLIDevices(void) 
The files to be included are: 
- mviDLLib.h 
DESCRIPTION 
This function creates the FIFO devices which are part of the Data Link Handler Interface. 
RETURNS 


MviOk or, if the operation fails, MviError. 


3.5.4.14 MviOpenPHIDevices 
NAME 
mviOpenPHIDevices - open Protocol Handler Interface devices 
SYNOPSIS 
MviStatus mviOpenPHIDevices(MviGlobalData* globalDataPtr, int taskInstance) 
globalDataPtr, a pointer to the Protocol Handler common global data structure 
taskInstance, instance number of the task spawned. Instances are numbered | - n. 
The files to be included are: 
- mviDLLib.h 
DESCRIPTION 
This function opens the FIFO devices which are part of the Protocol Handler Interface. 
RETURNS 


MviOk or, if the operation fails, MviError. 


3BSE 015 373R0001 3-47 


MultiVendor Interface - Protocol Development Kit Advant® Controller 400 Series User’s Guide 
Chapter 3 Configuration/Application Building 


3.5.4.15 MviOpenDLIDevices 
NAME 
mviOpenDLIDevices - open Data Link Handler Interface devices 
SYNOPSIS 


MviStatus mviOpenDLIDevices(int* fdDownCmndPtr, 
int* fdDownRespPtr, 
int* fdUpCmndPtr, 
int* fdUpRespPtr, 
MviHandlerType handlerType, 
u_int8 taskInstance) 


fdDownCmndPtr, pointer to filedescriptor fdDownCmnd 

fdDownRespPtr, pointer to filedescriptor fdDownResp 

fdUpCmndPtr, pointer to filedescriptor fdUpCmnd 

fdUpRespPtr, pointer to filedescriptor fdUpResp 

handlerType, type of handler, DL-handler or NL-handler 

taskInstance, instance number of the task spawned. Instances are numbered | - n. 
The files to be included are: 

- mviDLLib.h 
DESCRIPTION 

This function opens the FIFO devices between DL-Handler and NL-Handler 
RETURNS 


MviOk or, if the operation fails, MviError. 


3.5.4.16 MviCreateTimerDevices 
NAME 
mviCreateTimerDevices - create Watchdog Timer devices 
SYNOPSIS 
MviStatus mviCreateTimerDevices(u_int8 taskInstance) 
taskInstance, instance number of the task spawned. Instances are numbered | - n. 
The files to be included are: 


- mviDLLib.h 
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DESCRIPTION 


This function creates the Watchdog Timer devices which are used by the Protocol Handler. 
The devices are named “/wdTimer/index” where index is: 


x000 - x099 PollTimers, one for each node 
x100 Transmission timer 
x101 Acknowledge timer 
x102 System Watchdog Timer 
x103 - x109 Reserved 
x110 - x119 Free 
x = taskInstance. 
RETURNS 


MviOk or, if the operation fails, MviError. 


3.5.4.17 MviOpenTimerDevices 
NAME 


mviOpenTimerDevices - open Watchdog Timer devices 
SYNOPSIS 


MviStatus mviOpenTimerDevices(MviDL* d1Ptr, 
int* txTimerFdPtr, 
int* ackTimerFdPtr, 
int* watchdogTimerFdPtr, 
MviHandlerType handlerType) 


dlPtr, a pointer to the DL data structure 

txTimerFdPtr, a pointer to the txTimer file descriptor 

ackTimerFdPtr, a pointer to the ackTimer file descriptor 

watchdogTimerFdPtr, a pointer to the watchdogTimer file descriptor 

handlerType specifies the type of handler for which the DL structure is to be initiated 
The files to be included are: 

- mviDLLib.h 
DESCRIPTION 


This function opens the Watchdog Timer devices which are used by the Protocol Handler. 
The devices opened are : 


/wdTimer/x100 Transmission timer 
/wdTimer/x101 Acknowledge timer 
/wdTimer/x102 System Watchdog Timer 
x = taskInstance. 


RETURNS 


MviOk or, if the operation fails, MviError. 
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3.5.4.18 MviFetchSetupIinfo 
NAME 
mviFetchSetupInfo - fetch initialization information from application 
SYNOPSIS 


MviStatus mviFetchSetupInfo(MviDL* dIPtr, MviGlobalData* globalDataPtr, u_int32 
numOfCmnds) 


dlPtr, a pointer to the DL data structure 

globalDataPtr, a pointer to the global data structure 

numOfCmnds, number of down stream commands that can be pending. 
The files to be included are: 

- mviDLLib.h 
DESCRIPTION 


This function fetches initialization information, for the Protocol Handler, from the 
application. 


RETURNS 


MviOk or, if the operation fails, MviError. 


3.5.4.19 MvilnitDLStruct 
NAME 
mvilnitDLStruct - initialize the DL structure 
SYNOPSIS 


MviStatus mvilnitDLstruct(MviDL* dlPtr, 
size_t noOfReadBuffers, 
size_t noOfWriteBuffers, 
size_t dlEntrySize, 
u_int8 taskInstance, 
MviHandlerType handlerType) 


dlPtr, a pointer to the DL structure 

noOfReadBuffers, number of read buffers used by the Protocol Handler 

noOfWriteBuffers, number of write buffers used by the Protocol Handler 

dlEntrySize, size of protocol specific dlEntry struct 

taskInstance, instance number of the task spawned. Instances are numbered | - n. 

handlerType specifies the type of handler for which the DL structure is to be initiated 
The files to be included are: 


- mviDLLib.h 
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DESCRIPTION 


This function allocates data structures associated with the DL structure and initializes the 
DL structure, common part of DL-entry, status info structure and diagnostic info structure. 


RETURNS 


MviOk or, if the operation fails, MviError. 


3.5.4.20 MvilnitGlobalDataStruct 
NAME 
mvilnitGlobalDataStruct - initializes the common part of the GlobalData structure 
SYNOPSIS 
MviStatus mvilnitGlobalDataStruct(MviGlobalData globalDataPtr) 
globalDataPtr, a pointer to the global data structure 
The files to be included are: 
- mviDLLib.h 
DESCRIPTION 


This function allocates data structures associated to the GlobalData structure and 
initializes the GlobalData structure. 


RETURNS 


MviOk or, if the operation fails, MviError. 


3.5.4.21 MviMakeWDTDevName 
NAME 
mviMakeWDTDevName - creates a device name string for Watchdog Timer devices 
SYNOPSIS 
char* mviMakeWDTDevName( char strBuf, u_int16 devIndex) 
strBuf, the buffer in which to return the string 
devIndex, device instance number 
The files to be included are: 
- mviDLLib.h 
DESCRIPTION 
Returns the device name for the given parameters. 
RETURNS 


Pointer to the device name string. 
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3.5.4.22 MviPHiCleanup 
NAME 
mviPHICleanup - frees memory for data structures allocated and closes devices opened 
SYNOPSIS 


void mviPHICleanup(MviDL* dlPtr, MviglobalData* globalDataPtr, 
MviHandlerType handlerType) 


diPtr, a pointer to the DL data structure 

globalDataPtr, a pointer to the global data structure 

handlerType specifies the type of handler for which the DL structure is to be initiated 
The files to be included are: 

- mviDLLib.h 
DESCRIPTION 


This function frees memory for data structures allocated and closes devices previously 
opened by MVI support routines. The pointers in the MviDL struct cannot be used until a 
new initialization is done. 


NOTE 


Data structures allocated and devices opened explicitly by the Protocol Handler 
must be handled separately. 
RETURNS 


Nothing returned. 


3.5.4.23 MviDLICleanup 
NAME 
mviDLICleanup - frees memory for data structures allocated and closes devices opened 
SYNOPSIS 


void mviDLICleanup(MviDL* d1Ptr, MviglobalData* globalDataPtr, 
MviHandlerType handlerType) 


diPtr, a pointer to the DL data structure 

globalDataPtr, a pointer to the global data structure 

handlerType specifies the type of handler for which the DL structure is to be initiated 
The files to be included are: 


- mviDLLib.h 
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DESCRIPTION 


This function frees memory for data structures allocated and closes devices previously 
opened by MVI support routines. The pointers in the MviDL struct cannot be used until a 
new initialization is done. 


WARNING! Data structures allocated and devices opened explicitly by the Protocol 
Handler must be handled separately. 


RETURNS 


Nothing returned. 


3.5.4.24 MviPHIWaitForModemSignals 

NAME 
mviPHIWaitForModemSignals - waits for modem signals to become active 

SYNOPSIS 
DxBoolean mviPHIWaitForModemSignals(MviDL* dlPtr, MviGlobalData* globalDPtr) 
diPtr, a pointer to the DL data structure 
globalDPtr, a pointer to the global data structure 

The files to be included are: 
- mviDLLib.h 

DESCRIPTION 


This function waits for the modem signals DCD CTS and DSR tobecome active in a 
Protocol Handler which is not divided intoseparate Network and Data Link Layers. 
Depending on if the communication is made over a dial-up line or the UART is working in 
half or full duplex mode, different combinations of the modemsignals are waited for: 


— Dial-up line: either one of DSR or CTS signal are waited for. 
— Half Duplex: DSR is waited for. 
— Full Duplex: all of DCD CTS and DSR are waited for. 


This function also supervise PHI Down Stream and Local commands. All Down Stream 
commands are responded to with response code‘MviCRspHandlerBusy’. All Local 
commands except ‘MviRestartHndl’ are responded to with response code 
‘MviCRspHandlerBusy’. If a Local command ‘MviRestartHndl’ is received, a response is 
sent with response code ‘MviCRspOk and the function terminates. 


RETURNS 


When the proper modem signals are active, the function returns DxTrue. If a Local 
command ‘MviRestartHndl’ is received, the function returns DxFalse. 
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3.5.4.25 MviDLIWaitForModemSignals 

NAME 
mviDLIWaitForModemSignals - waits for modem signals to become active 

SYNOPSIS 
DxBooleanmviDLIWaitForModemSignals(MviDL* dlPtr, MviGlobalData* globalDPtr) 
dlPtr, a pointer to the DL data structure 
globalDPtr, a pointer to the global data structure 

The files to be included are: 
- mviDLLib.h 

DESCRIPTION 


This function waits for the modem signals DCD CTS and DSR to become active, in the 
Data Link Layer of a Protocol Handler which is divided into separate Network and Data 
Link Layers. Depending on if the communication is made over a dial-up line or the UART 
is working in half or full duplex mode, different combinations of the modem signals are 
waited for: 


— Dial-up line: either one of DSR or CTS signal are waited for. 
— Half Duplex: DSR is waited for. 
— Full Duplex: all of DCD CTS and DSR are waited for. 


This function also supervise DLI Down commands. All DLI Down commands except 
‘MviDLISetupInfo’ are responded to with responsecode ‘MviDLIRspDLNotReady’. If a 
DLI Down command ‘MviDLISetupInfo’is received, a response is sent with response 
code ‘MviDLIRspOk and the function terminates. 


RETURNS 


When the proper modem signals are active, the function returns DxTrue. If a DLI Down 
command ‘MviDLSetupInfo’ is received, the function returns DxFalse. 
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3.5.4.26 MviSysMess 
NAME 
mviSysMess - send a system message 
SYNOPSIS 


void mviSysMess(int32 component, int32 msgNum, int32 datal, 
int32 data2, char* text, char* module, UINT16 line) 


component identifies the software unit which discovered the error. This should be one of 
the MVI components defined in vxbsSysMess.h. 


msgNum, error code 

datal, field 1 for additional information 

data2, field 2 for additional information 

text, a text string which can be used for a description of the error 

module, the name of the source file that sent the system message (see below!) 

line, the line in the source file where the system message was sent (see below!) 
The files to be included are: 

- mviSysMess.h 

- vxbsSysMess.h 
DESCRIPTION 


This routine sends a system message. All the data is copied into the system message queue, 
so there is no need to preserve the arguments after the call of mviSysMess. 


If the system message queue is full, the message is lost and an error message is displayed 
(printed on stderr). When there is room in the message queue again, a system message 
indicating that one or more messages have been lost is sent. 


If the message queue is filled to the 80 percent mark or higher, a system message saying 
that the queue is almost full is sent. 


In Advant Controller 400, the system message is sent to the process station, mapped on a 
CX system message and sent to the system message queue. Component is mapped on 
Mcode, msgNum is mapped on trace number, datal and data2 are mapped on datal and 
data2, respectively, and text is discarded. 


Always set module = ___FILE__ and line = __LINE__. These macros are automatically 
translated into the correct file name and line number. 
RETURNS 


Nothing returned. 
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3.5.5 MVI Protocol Handler Interface 


3-56 


MVI Protocol Handler Interface provides a set of functions that encapsulate the inter-task 
communication between the Protocol Handler and the Host Interface, see Figure 3-9. 


The following functionality is provided to comprise the interface between the Protocol Handler 
and Host Interface: 


° Send Diagnostics Information 


— This function sends Diagnostic Information to the Host Interface. This information 
includes communication link quality such as number of modem signal errors, parity 
errors, checksum errors, framing errors, character time-out errors and number of re- 
transmissions. 


° Send Watchdog Messages 


— This function sends Watchdog messages to the Host Interface. These messages are 
sent to the Host and can be used to monitor the Protocol Handler, whether it is alive 
or not. 


° Send Status Information 


— This function sends Status Information to the Host Interface. The Status Information 
includes Link Status, which tells whether the PLCs on the communication link are 
reachable. Most of the Status Information is protocol specific. 


° Read setup parameters / Send setup parameters 


— These functions are used by the Protocol Handler to make a request for, and receive 
setup information from the Host System. This information includes the line 
characteristics used to initialize the UART. It also includes information about the 
PLCs on the communication link. 


° Local Command / Local Response 


— These functions are used by the Protocol Handler to receive and respond to 
commands directed towards the Protocol Handler itself. The type of commands sent 
are control commands, see Table 3-2. 


° Down Stream Command / Down Stream Response 


— These functions are used by the Protocol Handler to receive and respond to read and 
write commands directed towards a remote node on the communication link. See 
Table 3-2. 


° Up Stream Command / Up Stream Response. 


— These functions are used by the Protocol Handler to send and wait for response of 
read and write commands directed towards the Host System. These commands are 
built by the Protocol Handler when receiving a command message from a remote 
node on the communication link. See Table 3-2. 


The inter-task communication is handled using pipes M 


1. A pipe is a data structure used for inter-task communication. 
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The functions that provide the functionality described above, see Section 3-9, MVI Protocol 
Handler Interface, result in a data/command message exchange between the Protocol Handler 
and the Host Interface. Each of the functions described above will have a dedicated pipe, to 
allow a flexible flow control between the Host Interface and the Protocol Handler. 


The Host Interface handles the communication with the Host System. It also handles data and 
information conversion between the Host System and the Protocol Handler Interface. 


Host Interface Pipe Protocol Handler 
mviGetPHIReqSetup() Ps ~<“l——, Read Setup Param ————_ mviReqPHlSetup() 
mviSendPH!|SetupInfo() i jp — Send Setup Param }——" mviGetPHISetupInfo() 
mviGetPHIDiagInfo() ~«@— Send Diagnostics —————+ mviSendPHIDiagInfo() 
mviGetPHIWatchdog() ~<a Send Watchdog }#—— mviSendPHIWatchdog() 
mviGetPHI|StatusInfo() ~«q@— Send Status Info /}——4 mviSendPH|StatusInfo() 


mviSendPHIDownCmnd() 


Down Stream Cmd ||. - ._- mviGetPHIDownCmnd() 


mviGetPHIDownResp() _-7 -|~@— Down Stream Resp ;} =e ' mvSendPHliDownResp() 
mviGetPHIUpCmnd() : et UpStream Cmd -—— mviSendPHIUpCmnd() 
mviSendPHIUpResp() ——— Up Stream Resp [>——®™|_s mviGetPHIUpResp() 
mviSendPHILocalDownCmnd() |————_ Local Command [->——3>; - ‘ mviGetPHILocalDownCmnd() 


mviGetPHILocalDownResp() ~4— local Response -———7<@ MviSendPHiLocalDownResp() 


Figure 3-9. Interface between Protocol Handler and Host Interface 
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There are two types of Protocol Handler Interface functions: information functions used by the 
Protocol Handler to send information to the Host Interface and functions that rely on a 
command/response protocol that must be fulfilled. 


The following functions do not use a command / response protocol: 
° Send Diagnostics 
— The Protocol Handler sends a Diagnostics Information message to the Host Interface 


using the function mviSendPHIDiagInfo. 


NOTE 


This function shall never be called directly from the Protocol Handler. It is called 
automatically by the function mviFetchSetupInfo. 


° Send Watchdog 


— The Protocol Handler sends a Watchdog message to the Host Interface using the 
function mviSendPHI Watchdog. 


NOTE 


This function shall never be called directly from the Protocol Handler. It is called 
automatically by the function mviSelect. 


° Send Status Info 


— The Protocol Handler sends a Status Information message to the Host Interface using 
the function mviSendPHIStatusInfo. 
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The following functions rely on a command / response protocol, which must be fulfilled: 
° Read Setup Param / Send Setup Param 


— The Protocol Handler sends a Read Setup Param request to the Host Interface using 
the function mviPHIReqSetup and waits for the response. After receiving the 
request, the Host Interface sends the setup parameters. The Protocol Handler receives 
the setup parameters which are fetched using the function mviGetPHISetupInfo. 


NOTE 


These functions shall never be called directly from the Protocol Handler. They are 
called automatically by the function mviFetchSetupInfo. 


° Down Stream Command / Down Stream Response 


— The Protocol Handler receives a Down Stream Command from the Host Interface, 
which is fetched using the function mviGetPHIDownCmnd. After the command has 
been handled, the Protocol Handler sends a response to the Host Interface using the 
function mviSendPHIDownResp. 


° Up Stream Command / Up Stream Response 


— The Protocol Handler sends an Up Stream Command to the Host Interface using the 
function mviSendPHIUpCmnd and waits for a response. After the command has 
been handled, the Protocol Handler receives a response message, which is fetched 
using the function mviGetPHIUpResp. 


° Local Command / Local Response 


— The Protocol Handler receives a Local Command from the Host Interface, which is 
fetched using the function mviGetPHILocalDownCmnd. After the command has 
been handled, the Protocol Handler sends a response to the Host Interface using the 
function mviSendPHILocalDownResp. 
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Table 3-2 below describes the Commands supported by MVI Protocol Handler Interface. 


Table 3-2. MVI Protocol Handler Interface Commands 


Command Command 


Type Code Name Description 
Control Commands 1 MviRestartHndl Re-starts the Protocol Handler. 
Local 
oral Semmates) 2 MviResetDiag Resets the Diagnostics Information Structure. 
3 MviDialStation Tells the Protocol Handler to dial a remote node 
4 MviHangupLine Tells the Protocol Handler to hang up the line to a 
remote node 
5 MviNodeConn Used by the Protocol Handler to inform the Host 
that the connection with a remote node is 
established. 
6 MviNodeDisConn Used by the Protocol Handler to inform the Host 


that the connection with a remote node is lost. 


7 MviGetDiag Used to get diagnostic data. 
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Table 3-2. MVI Protocol Handler Interface Commands (Continued) 


Command Command 


Type Code Name Description 


Read Commands 101 MviRdSngllnt16 Read one 16 bit integer value from a remote node in 
(Downstream and case of a Downstream Command, or from the Host 
Upstream System in case of an Upstream Command. 

Commands) 


102 MviRdMultInt16 Read a number of 16 bit integer values from a 
remote node in case of a Downstream Command, 
or from the Host System in case of an Upstream 
Command. 


103 MviRdSngllnt32 Read one 32 bit integer value from a remote node in 
case of a Downstream Command, or from the Host 
System in case of an Upstream Command. 


104 MviRdMultInt32 Read a number of 32 bit integer values from a 
remote node in case of a Downstream Command, 
or from the Host System in case of an Upstream 
Command. 


105 MviRdSngIBool Read one boolean value from a remote node in 
case of a Downstream Command, or from the Host 
System in case of an Upstream Command. See 
Figure 3-10 for the byte order of boolean data in the 
Application Data field of the MviCmndlnfo structure. 


106 MviRdMultBool Read a number of boolean values from a remote 
node in case of a Downstream Command, or from 
the Host System in case of an Upstream Command. 
See Figure 3-10 for the byte order of boolean data 
in the Application Data field of the MviCmndlInfo 
structure. 


107 MviRdSngIFloat Read one float value from a remote node in case of 
a Downstream Command, or from the Host System 
in case of an Upstream Command. 


108 MviRdMultFloat Read a number of float values from a remote node 
in case of a Downstream Command, or from the 
Host System in case of an Upstream Command. 


109 MviRdString Read one string value from a remote node in case 
of a Downstream Command, or from the Host 
System in case of an Upstream Command. 


110 MviRdMix32 Read a number of 32 bit values from a remote node 
in case of a Downstream Command, or from the 
Host System in case of an Upstream Command. 
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Table 3-2. MVI Protocol Handler Interface Commands (Continued) 


Command 
Type 


Command 
Code 


Name 


Description 


Write Commands 
(Downstream and 
Upstream 
Commands) 


201 


MviWrSngllnt16 


Write one 16 bit integer value to a remote node in 
case of a Downstream Command, or to the Host 
System in case of an Upstream Command. 


202 


MviWrMultInt16 


Write a number of 16 bit integer values to a remote 
node in case of a Downstream Command, or to the 
Host System in case of an Upstream Command. 


203 


MviWrSngllnt32 


Write one 32 bit integer value to a remote node in 
case of a Downstream Command, or to the Host 
System in case of an Upstream Command. 


204 


MviWrMultInt382 


Write a number of 32 bit integer values to a remote 
node in case of a Downstream Command, or to the 
Host System in case of an Upstream Command. 


205 


MviWrSngIBool 


Write one boolean value to a remote node in case of 
a Downstream Command, or to the Host System in 
case of an Upstream Command. See Figure 3-10 
for the byte order of boolean data in the Application 
Data field of the MviCmndlnfo structure. 


206 


MviWrMultBool 


Write a number of boolean values to a remote node 
in case of a Downstream Command, or to the Host 
System in case of an Upstream Command. See 

Figure 3-10 for the byte order of boolean data in the 
Application Data field of the MviCmndlnfo structure. 


207 


MviWrSngIFloat 


Write one float value to a remote node in case of a 
Downstream Command, or to the Host System in 
case of an Upstream Command. 


208 


MviWrMultFloat 


Write a number of float values to a remote node in 
case of a Downstream Command, or to the Host 
System in case of an Upstream Command. 


209 


MviWrString 


Write one string value to a remote node in case of a 
Downstream Command, or to the Host System in 
case of an Upstream Command. 


210 


MviWrMix32 


Write a number of 32 bit values to a remote node in 
case of a Downstream Command, or to the Host 
System in case of an Upstream Command. 


Miscellaneous 
Commands 


301 


MviColdStart 


Send Cold start command to PLC/RTU slave. 


302 


MviWarmStart 


Send Warm start command to PLC/RTU slave. 


305 


MviNormalize 


Send Normalize command to PLC/RTU slave. 
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NOTE1 


Many Read/Write commands have one Sng! variant and one Mult variant. The 
selection between them is made by the value of NOOFREGS in the MVB Data 
Base Element sending the command. 

If NOOFREGS is | then the Sng/ variant of the command is received by the 
Protocol Handler and if it is >1, then the Mult variant is received. 


NOTE2 


The MVI Protocol Handler Interface commands MviRdString and MviWrString 
are currently not supported. 


The byte order for multiple boolean data in the Application Data field of the MviCmndInfo Data 


Structure is shown in Figure 3-10. For a single boolean value bit 0 of byte 0 is used. That is, for 
a boolean value of 0, bit 0 of byte 0 is cleared. For a boolean value of 1, bit 0 of byte 0 is set. 


Single Boolean Values 


Byte 0 Byte 0 


Bit 0=0 | = Boolean Value 0 BitO=1 | = Boolean Value 1 


Multiple Boolean Values 
ByteO Byte1 Byte 2 Byte3 Byte 4 Byte5 Byte6 ! Byte 250 


I) Bit 2000 
i|- 1993 


Bit 7-0 | Bit 15-8 | Bit 23-16 | Bit 31-24 | Bit 39-32 | Bit 47-40 | Bit 55-48 


Figure 3-10. Application Data field of the MviCmndInfo Data Structure 


The byte order for integer (1), integer long (IL), and real (R), is shown in Figure 3-11. 
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16-bit Integer Values 


First Integer 16 Second Integer 16 Third Integer 16 Fourth Integer 16 


Bit 15-8 | Bit 7-0 |Bit 31-24 


Bit 23-16 i 740i 39.22 63-56|Bit 55-48 


32-bit Integer Values and Floats (real) 


First Integer 32 or Float (real) Second Integer 16 or Float (real) 


Bit 55-48 |Bit 47-40|Bit 39-32 


Bit 2124 2.14 Bit 15-8 | Bit 7-0 i 63-56 


Figure 3-11. Mapping 8-bit, 16-bit and 32-bit Data on the Application Data Field 


For a description of data structures, refer to the include file mviProtInt.h which is part of 
MVIBase. 


3.5.5.1 MviReqPHISetup 
NAME 
mviReqPHISetup - sends a request message from Protocol Handler to the Host Interface 
SYNOPSIS 
MviStatus mviReqPHISetup(int fileDescr, MviSetupReqMess **suMessage) 
fileDescr, file descriptor for the pipe 
suMessage, pointer to pointer to a setup request message struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function sends a request message for setup parameters from the Protocol Handler to 
the Host Interface. If MviReqPHISetup is called, the same function may not be called 
again until a response is received by mviGetPHISetupInfo. 


RETURNS 
MviOk or, if the operation fails, MviWriteError. 
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3.5.5.2 MviGetPHliReqSetup 
NAME 


mviGetPHIReqSetup - receives a request message for setup parameters from the Protocol 
Handler 


SYNOPSIS 
MviStatus mviGetPHIReqSetup(int fileDescr, MviSetupReqMess **suMessage) 
fileDescr, file descriptor for the pipe 
suMessage, pointer to pointer to a setup request message struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 
This function receives a request message for setup parameters from the Protocol Handler. 
RETURNS 


MviOk or, if the operation fails, MviReadError. 


3.5.5.3 MviSendPHlISetupInfo 
NAME 


mviSendPHISetupInfo - sends a setup response message from Host Interface to Protocol 
Handler 


SYNOPSIS 
MviStatus mviSendPH]SetupInfo(int fileDescr, MviProtSetupInfo **setupData) 
fileDescr, file descriptor for the pipe 
setupData, a pointer to a pointer to parameter struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function sends a setup parameter response message from the Host Interface to the 
Protocol Handler. 


RETURNS 


MviOk or, if the operation fails, MviWriteError. 
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3.5.5.4 MviGetPHISetupInfo 
NAME 
mviGetPHISetupInfo - receives setup parameters from the Host Interface 
SYNOPSIS 
MviStatus mviGetPHISetupInfo(int fileDescr, MviProtSetupInfo **setupData) 
fileDescr, file descriptor for the pipe 
setupData, a pointer to a pointer to parameter struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Protocol Handler to receive setup parameters from the Host 
Interface. 


RETURNS 


MviOk or, if the operation fails, MviReadError. 


3.5.5.5 MviSendPHIWatchdog 
NAME 


mviSendPHIWatchdog - sends a Watchdog message from Protocol Handler to Host 
Interface 


SYNOPSIS 
MviStatus mviSendPHI Watchdog(int fileDescr, MviWatchdogMess **wdMessage) 
fileDescr, file descriptor for the pipe 
wdMessage, pointer to a pointer to a Watchdog message 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Protocol Handler to send a Watchdog message to the Host 
Interface. 


RETURNS 


MviOk or, if the operation fails, MviWriteError. 
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3.5.5.6 MviGetPHIWatchdog 
NAME 
mviGetPHI Watchdog - receives a Watchdog message from the Protocol Handler 
SYNOPSIS 
MviStatus mviGetPHI Watchdog(int fileDescr, MviWatchdogMess **wdMessage) 
fileDescr, file descriptor for the pipe 
wdMessage, pointer to a pointer to a Watchdog message 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Host Interface to receive a Watchdog message from the 
Protocol Handler. 


RETURNS 


MviOk or, if the operation fails, MviReadError. 


3.5.5.7 MviSendPHIDiagInfo 
NAME 
mviSendPHIDiagInfo - sends a diagnostic information to the Host Interface 
SYNOPSIS 
MviStatus mviSendPHIDiagInfo(int fileDescr, MviDiagInfo **diagData) 
fileDescr, file descriptor for the pipe 
diagData, a pointer to a pointer to the data struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Protocol Handler to send the diagnostic information to the 
Host Interface. 


RETURNS 


MviOk or, if the operation fails, MviWriteError. 
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3.5.5.8 MviGetPHIDiagInfo 
NAME 
mviGetPHIDiagInfo - receives diagnostic information from the Protocol Handler 
SYNOPSIS 
MviStatus mviGetPHIDiagInfo(int fileDescr, MviDiagInfo **diagData) 
fileDescr, file descriptor for the pipe 
diagData, a pointer to a pointer to the data struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Host Interface to receive diagnostic information from the 
Protocol Handler. 


RETURNS 
MviOk or, if the operation fails, MviReadError. 


3.5.5.9 MviSendPHIStatusinfo 
NAME 
mviSendPHIStatusInfo - sends status message to the Host Interface 
SYNOPSIS 
MviStatus mviSendPHIStatusInfo(int fileDescr, MviNodeStat **statusInfo) 
fileDescr, file descriptor for the pipe 
statusInfo, a pointer to a pointer to the info struct for the node in question 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Protocol Handler to send a status change message to the Host 
Interface. Status change messages contain information about the communication link 
status (up/down), illegal requests and illegal use of functions. 


RETURNS 


MviOk or, if the operation fails, MviWriteError. 
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3.5.5.10 MviGetPHIStatusinfo 
NAME 
mviGetPHIStatusInfo - receive status information from the Protocol Handler 
SYNOPSIS 
MviStatus mviGetPHIStatusInfo(int fileDescr, MviNodeStat **statusInfo) 
fileDescr, file descriptor for the pipe 
statusInfo, a pointer to a pointer to the info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Host Interface to receive status information from the Protocol 
Handler. 


RETURNS 


MviOk or, if the operation fails, MviReadError. 


3.5.5.11_ MviSendPHILocalDownCmnd 
NAME 
mviSendPHILocalDownCmnd - send a local command message to the Protocol Handler 
SYNOPSIS 
MviStatus mviSendPHILocalDownCmnd(int fileDescr, MviCmndInfo **command) 
fileDescr, file descriptor for the pipe 
command, a pointer to a pointer to the command info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Host Interface to send a local command message to the 
Protocol Handler. If mviSendPHILocalDownCmnd is called, the same function must not 
be called again until a response has been received by mviGetPHILocalDownResp. 


RETURNS 


MviOk or, if the operation fails, MviWriteError. 


3BSE 015 373R0001 3-69 


MultiVendor Interface - Protocol Development Kit Advant® Controller 400 Series User’s Guide 
Chapter 3 Configuration/Application Building 


3.5.5.12 MviGetPHiLocalDownCmnd 
NAME 
mviGetPHILocalDownCmnd - receives a local command message from the Host Interface 
SYNOPSIS 
MviStatus mviGetPHILocalDownCmnd(int fileDescr, MviCmndInfo **command) 
fileDescr, file descriptor for the pipe 
command, a pointer to a pointer to the command info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Protocol Handler to receive a local command message from 
the Host Interface. 


RETURNS 


MviOk or, if the operation fails, MviReadError. 


3.5.5.13 MviSendPHILocalDownResp 
NAME 
mviSendPHILocalDownResp - sends a local response messages to the Host Interface 
SYNOPSIS 
MviStatus mviSendPHILocalDownResp(int fileDescr, MviCmndInfo **response) 
fileDescr, file descriptor for the pipe 
response, a pointer to a pointer to the respond info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Protocol Handler to send a local response message to the Host 
Interface. 


RETURNS 


MviOk or, if the operation fails, MviWriteError. 
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3.5.5.14 MviGetPHILocalDownResp 
NAME 


mviGetPHILocalDownResp - receives a local response message from the Protocol 
Handler 


SYNOPSIS 
MviStatus mviGetPHILocalDownResp(int fileDescr, MviCmndInfo **response) 
fileDescr, file descriptor for the pipe 
response, a pointer to a pointer to the response info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Host Interface to receive a local response message from the 
Protocol Handler. 


RETURNS 


MviOk or, if the operation fails, MviReadError. 


3.5.5.15 MviSendPHIDownCmnd 
NAME 


mviSendPHIDownCmnd - sends a Down Stream command message to the Protocol 
Handler 


SYNOPSIS 
MviStatus mviSendPHIDownCmnd(int fileDescr, MviCmndInfo **command) 
fileDescr, file descriptor for the pipe 
command, a pointer to a pointer to the command info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Host Interface to send a Down Stream command messages to 
the Protocol Handler. If MviSendPHIDownCmnd is called, the same function must not be 
called again until a response is received by mviGetPHIDownResp. 


RETURNS 


MviOk or, if the operation fails, MviWriteError. 
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3.5.5.16 MviGetPHIDownCmnd 
NAME 


mviGetPHIDownCmnd - receives a Down Stream command message from the Host 
Interface 


SYNOPSIS 
MviStatus mviGetPHIDownCmnd(int fileDescr, MviCmndInfo **command) 
fileDescr, file descriptor for the pipe 
command, a pointer to a pointer to the command info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Protocol Handler to receive a Down Stream command 
messages from the Host Interface. 


RETURNS 


MviOk or, if the operation fails, MviReadError. 


3.5.5.17 MviSendPHIDownResp 
NAME 
mviSendPHIDownResp - send a Down Stream response message to the Host Interface 
SYNOPSIS 
MviStatus mviSendPHIDownResp(int fileDescr, MviCmndInfo **response) 
fileDescr, file descriptor for the pipe 
response, a pointer to a pointer to the response info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Protocol Handler to send a Down Stream response message to 
the Host Interface. 


RETURNS 


MviOk or, if the operation fails, MviWriteError. 
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3.5.5.18 MviGetPHIDownResp 
NAME 


mviGetPHIDownResp - receives a Down Stream response message from the Protocol 
Handler 


SYNOPSIS 
MviStatus mviGetPHIDownResp(int fileDescr, MviCmndInfo **response) 
fileDescr, file descriptor for the pipe 
response, a pointer to a pointer to the response info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Host Interface to receive a Down Stream response message 
from the Protocol Handler. 


RETURNS 


MviOk or, if the operation fails, MviReadError. 


3.5.5.19 MviSendPHIUpCmnd 
NAME 
mviSendPHIUpCmnd - sends an Upstream Command message to the Host Interface 
SYNOPSIS 
MviStatus mviSendPHIUpCmnd(int fileDescr, MviCmndInfo **command) 
fileDescr, file descriptor for the pipe 
command, a pointer to a pointer to the command info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Protocol Handler to send an Upstream Command message to 
the Host Interface. If MviSendPHIUpCmnd is called, the same function must not be called 
again until a response is received by MviGetPHIUpResp. 


RETURNS 


MviOk or, if the operation fails, MviWriteError. 


3BSE 015 373R0001 3-73 


MultiVendor Interface - Protocol Development Kit Advant® Controller 400 Series User’s Guide 
Chapter 3 Configuration/Application Building 


3.5.5.20 MviGetPHIUpCmnd 
NAME 


mviGetPHIUpCmnd - recieves an Upstream Command message from the Protocol 
Handler 


SYNOPSIS 
MviStatus mviGetPHIUpCmnd(int fileDescr, MviCmndInfo **command) 
fileDescr, file descriptor for the pipe 
command, a pointer to a pointer to the command info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Host Interface to receive an Upstream Command message 
from the Protocol Handler. 


RETURNS 


MviOk or, if the operation fails, MviWriteError. 


3.5.5.21 MviSendPHIUpResp 
NAME 
mviSendPHIUpResp - sends an Upstream Response message to the Protocol Handler 
SYNOPSIS 
MviStatus mviSendPHIUpResp(int fileDescr, MviCmndInfo **response) 
fileDescr, file descriptor for the pipe 
response, a pointer to a pointer to the response info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Host Interface to send an Upstream Response message to the 
Protocol Handler. 


RETURNS 


MviOk or, if the operation fails, MviWriteError. 
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3.5.5.22 MviGetPHIUpResp 


NAME 
mviGetPHIUpResp - receives an Upstream Response message from the Host Interface 
SYNOPSIS 
MviStatus mviGetPHIUpResp(int fileDescr, MviCmndInfo **response) 
fileDescr, file descriptor for the pipe 
response, a pointer to a pointer to the response info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Protocol Handler to receive an Upstream Response message 
from the Host Interface. 


RETURNS 


MviOk or, if the operation fails, MviWriteError. 


3.5.6 MVI DataLink Interface 


3BSE 015 373R0001 


MVI Data Link Interface provides a set of functions that encapsulates the inter-task 
communication between the Network Handler and the Data Link Handler, in case of a Protocol 
Handler split into two tasks, see Figure 3-12. 


The following functionality is provided to comprise the interface between the Network Handler 
task and the Data Link Handler task in a split Protocol Handler: 


° DLI Down Command / DLI Down Response 


- These functions are used to send commands from the Network Handler to the Data 
Link Handler and responses in the opposite direction. 


° DLI Up Command / DLI Up Response. 


- These functions are used to send commands from the Data Link Handler to the 
Network Handler and responses in the opposite direction. 


The inter-task communication is handled using pipes Ue 


The functions that provide the functionality described above, see Figure 3-12, result ina 
data/command message exchange between the Network Handler and the Data Link Handler. 
Each of the functions listed above will have a dedicated pipe to allow a flexible flow control 
between the two tasks. 


1. A pipe is a data structure used for inter task communication. 
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Network Handler 


mviSendDLIDownCmnd() 
mviGetDLIDownResp() 
mviGetDLIUpCmnd()_ | --~ 


mviSendDLIUpResp() * B 


Pipe 


Data Link Handler 


DLI Down Command 


—"g—  DLI Down Response 


~<ga— DLI Up Command 


DLI Up Response 


-————__ 


|} -. 


\ 


>i ' mviSendDLIDownResp() 


mviGetDLIDownCmnd() 


mviSendDLIUpCmnd() 


mviGetDLIUpResp() 


Figure 3-12. Interface between Network Handler and Data Link Handler 


The Data Link Interface functions rely on a command / response protocol that must be fulfilled: 
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DLI Down Command / DLI Down Response 


The Network Handler sends a command to the Data Link Handler using the function 
mviSendDLIDownCmnd, and waits for a response. The Data Link Handler fetches 
the command using the function mviGetDLIDownCmnd. After the command has 
been handled, the Data Link Handler sends a response message back to the Network 
Handler using the function mviSendDLIDownResp. The Network Handler fetches 
the response message using the function mviGetDLIDownResp. 


DLI Up Command / DLI Up Response. 


The Data Link Handler sends a command to the network Handler using the function 
mviSendDLIUpCmnd, and waits for a response. The Network Handler fetches the 
command using the function mviGetDLIUpCmnd. After the command has been 
handled, the Network Handler sends a response message back to the Data Link 
Handler using the function mviSendDLIUpResp. The Data Link Handler fetches the 
response message using the function mviGetDLIUpResp. 
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Table 3-3 below describes the commands supported by MVI Data Link Interface. 


Table 3-3. MVI Data Link Interface Commands 


Command one 
Code Name Description 

1 MviDLIRestartDL DLI Down Command: The Network handler uses this command code to 
Re-start the Data Link Handler. 

2 MviDLISetupInfo DLI Down Command: The Network handler uses this command code to 
send down the setup information for the UART, to the Data Link Handler 

3 MviDLIDataBuffer DLI Down Command: The Network Handler sends a data message, 
down to the Data Link Handler, addressed to a remote node on the 
communication link. 
DLI Up Command: The Data Link Handler sends a data message, coming 
from a remote node on the communication link, up to the Network Handler. 

4 MviDLIStatusReport DLI Up Command: The Data Link Handler sends a status report message 
up to the Network Handler 

5 MviDLILocalCmnd DLI Down Command: The Network Handler sends a local command 
down to the Data Link handler. This command code uses a sub-code, local 
command code, which is protocol specific, that is, with this command code 
the implementor can define any functionality. 


For a description of data structures, refer to the include file mviProtInt.h which is part of 
MVIBase. 


3.5.6.1 MviSendDLIDownCmnd 
NAME 


mviSendDLIDownCmnd - sends a DLI Down Stream command message to the Data Link 
Handler 


SYNOPSIS 
MviStatus mviSendDLIDownCmnd(int fileDescr, MviDLICmndInfo **command) 
fileDescr, file descriptor for the pipe 
command, a pointer to a pointer to the DLI command info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Network Handler to send a DLI Down Stream command 
message to the Data Link Handler. If this function is called, it should not be called again 
until a response has been received by mviGetDLIDownResp. 


RETURNS 
MviOk or, if the operation fails, MviWriteError. 
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3.5.6.2 MviGetDLIDownCmnd 
NAME 


mviGetDLIDownCmnd - receives a DLI Down Stream command message from the 
Network Handler 


SYNOPSIS 
MviStatus mviGetDLIDownCmnd(int fileDescr, MviDLICmndInfo **command) 
fileDescr, file descriptor for the pipe 
command, a pointer to a pointer to the DLI command info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Data Link Handler to receive a DLI Down Stream command 
message from the Network Handler. 


RETURNS 
MviOk or, if the operation fails, MviReadError. 


3.5.6.3 MviSendDLIDownResp 
NAME 


mviSendDLIDownResp - sends a DLI Down Stream response message to the Network 
Handler 


SYNOPSIS 
MviStatus mviSendDLIDownResp(int fileDescr, MviDLICmndInfo **response) 
fileDescr, file descriptor for the pipe 
response, a pointer to a pointer to the command info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Data Link Handler to send a DLI Down Stream response 
message to the Network Handler. 


RETURNS 


MviOk or, if the operation fails, MviWriteError. 
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3.5.6.4 MviGetDLIDownResp 
NAME 


mviGetDLIDownResp - receives a DLI Down Stream response message from the Data 
Link Handler 


SYNOPSIS 
MviStatus mviGetDLIDownResp(int fileDescr, MviDLCmndInfo **response) 
fileDescr, file descriptor for the pipe 
response, a pointer to a pointer to the coammand info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Network Handler to receive a DLI Down Stream response 
message from the Data Link Handler. 


RETURNS 
MviOk or, if the operation fails, MviReadError. 


3.5.6.5 MviSendDLIUpCmnd 


NAME 


mviSendDLIUpCmnd - sends a DLI Up Stream command message to the Network 
Handler 


SYNOPSIS 
MviStatus mviSendDLIUpCmnd(int fileDescr, MviDLICmndInfo **command) 
fileDescr, file descriptor for the pipe 
command, a pointer to a pointer to the DLI command info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Data Link Handler to send DLI Up Stream command 
messages to the Network Handler. If this function is called, it should not be called again 
until a response has been received by mviGetDLIUpResp. 


RETURNS 
MviOk or, if the operation fails, MviWriteError. 
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3.5.6.6 MviGetDLIUpCmnd 
NAME 


mviGetDLIUpCmnd - receives a DLI Up Stream command message from the Data Link 
Handler 


SYNOPSIS 
MviStatus mviGetDLIUpCmnd(int fileDescr, MviDLICmndInfo **command) 
fileDescr, file descriptor for the pipe 
command, a pointer to a pointer to the DLI command info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Network Handler to receive a DLI Up Stream command message 
from the Data Link Handler. 


RETURNS 
MviOk or, if the operation fails, MviReadError. 


3.5.6.7 MviSendDLIUpResp 
NAME 
mviSendDLIUpResp - sends a DLI Up Stream response message to the Data Link Handler 
SYNOPSIS 
MviStatus mviSendDLIUpResp(int fileDescr, MviDLICmndInfo **response) 
fileDescr, file descriptor for the pipe 
response, a pointer to a pointer to the command info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Network Handler to send a DLI response messages to the Data 
Link Handler. 


RETURNS 


MviOk or, if the operation fails, MviWriteError. 
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3.5.6.8 MviGetDLIUpResp 
NAME 


mviGetDLIUpResp - receives a DLI Up Stream response message from the from the 
network Handler 


SYNOPSIS 
MviStatus mviGetDLIUpResp(int fileDescr, MviDLCmndInfo **response) 
fileDescr, file descriptor for the pipe 
response, a pointer to a pointer to the command info struct 
The files to be included are: 
- mviProtInt.h 
DESCRIPTION 


This function is used by the Data Link Handler to receive a DLI Up Stream response 
message from the Network Handler. 


RETURNS 
MviOk or, if the operation fails, MviReadError. 


3BSE 015 373R0001 3-81 


MultiVendor Interface - Protocol Development Kit Advant® Controller 400 Series User’s Guide 


Chapter 3 Configuration/Application Building 


3.5.7 Protocol Configuration and Application Building for 


Advant Controller 400 


This section describes the Configuration data base elements used to configure the CI538 


submodule. These data base elements contain setup information for the hardware and software 
of the CI538 submodule. Status information is also received from CI538. The status information 


can be used by the application program. 


3.5.7.1 MVICHAN Data Base Element 


The line characteristics of CI538 are specified in one MVICHAN data base element for each 
communication channel. This means that one CI538 is fully configured by one MVIMOD data 


base element and two MVICHAN data base elements. 
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Figure 3-13. Overview of MVICHAN Data Base Element 
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Base Part 
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MVI Channel 
(356.1) 
MVCl1 1 4 NAME ERR 
0 2— MASTER ERRTYPE 
NONE 3 4 TIMESYNC NET | 
s2 + Communication 
$34 Parameters 


Figure 3-14. Data Base Element MVICHAN Base Part for MVI Protocol 


Table 3-4. Terminal Description for MVICHAN Base Part 


2 Value PC 
Terminal F Recommended : Paar 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 
1 NAME User MVCx aa Unique element NAME. Maximum 20 
characters 
2 MASTER User Oor 1 B(r/w) MVI channel in: = 
0 = slave mode 
1 = MASTER mode 
3 TIMESYNC User NONE = MVI TIME SYNChronization is not = 
applicable. 
4 ERR System 0 Bir) ERRor. - 
5 ERRTYPE System 0 IL(r) ERRor TYPE. - 
6 NET System 0 I(r) NETwork number of MVI channel. = 
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Figure 3-15. Data Base Element MVICHAN Communication for MVI Protocol 


Table 3-5. Terminal Description for MVICHAN Communication Part 


Terminal aus Recommended iis 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 
9 PROTTYPE User 20 I(r/w) PROTocol TYPE. 0..255 

10 DUPLEX User FULL I(r/w) DUPLEX mode, concerns modem = 
signals between MVI channel and 
modem. Values: 
FULL, HALF 

11 DIAL User 0 B(r/w) DIALing. - 


0 = disabled (used for private line) 
1 = enabled (used for dial line) 


12 SPEED User 9600 I(r/w) Transmission SPEED of = 
communication in bits/second. Values: 
150, 300, 600, 1200, 2400, 4800, 


9600, 19200 

13 CHLEN User 7ors I(r/w) CHaracter LENgbth in bits. Values: = 
7,8 

14 STOPBITS User 1 I(r/w) STOP BITS. Values: - 
0.5, 1, 1.5, 2 

15 PARITY User EVEN I(r/w) PARITY. Values: - 


NONE, ODD, EVEN 
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Table 3-5. Terminal Description for MVICHAN Communication Part (Continued) 


Terminal 
No. 


Terminal Name 


Value 
entered 
by 


Recommended 
Value 


PC 
Connection 
Data Type 


Description 


Remarks 


16 


LINESTAB 


User 


0 for full duplex 
1 for half duplex 


I(r/w) 


LINE STABilization time in number 

of character transmission times. 

Time to allow the carrier wave to 
stabilize before transmission of the first 
character. Restrictions for half duplex: 
“(own) LINESTAB time = (opposite 
side) CARRDEL time’. 

See Figure 3-17. 


0..15 


17 


CARRDEL 


User 


0 for full duplex 
1 for half duplex 


I(r/w) 


CARRier DELay time in number of 
character transmission times. Time to 
wait after the transmission of the last 
character before deactivating RTS. 
This delay is used to avoid destruction 
of the last character in the message, 
due to lost carrier. See Figure 3-17. 


18 


MAXRETR 


User 


2 for master 
0 for slave 


I(r/w) 


MAXimum number of 
RETRansmissions before line is 
considered broken. 


19 


CHARTOUT 


User 


I(r/w) 


CHARacter Time-OUT time in number 
of character transmission times. Used 
by receive routine to detect idle receive 
line. 

0: no check for time-out is made. 


20 


TURNTIME 


User 


100 


IL(r/w) 


TURN around TIME in milliseconds. 
Time to wait as from the last character 
inthe command until the first character 
in the reply, i.e. the time-out time. 


0..20000 


21 


UARTTOUT 


User 


1 for full duplex 
2 for half duplex 


I(r/w) 


UART transmission Time-OUT in 
number of character transmission 
times. If half duplex is used, a check of 
DCD will be made by the send routine 
before activating RTS. 

If DCD is activated the send routine will 
wait for DCD to be deactivated up to 
this time before aborting the 
transmission. 


22 


POLLCYCL 


User 


96000/SPEED for 
master 
1.2*96000/SPEED 
for slave 


I(r/w) 


Maximum time between two POLLing 
CYCLes in seconds. 


0..255 


38 


VALID 


System 


Signals DSR etc. is VALID 


39 


DSR 


System 


Modem signal Data Set Ready. 


40 


CTS 


System 


Modem signal Clear To Send 


41 


DCD 


System 


Data Carrier Defect 


42 


Rl 


System 


Modem signal Ring Indicator. 
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Figure 3-16. Data Base Element MVICHAN Parameters for MVI Protocol 


These parameters are used for protocol specific configuration parameters that are needed by the 
protocol handler. 


Table 3-6. Terminal Description for MVICHAN Parameter Part 


F Value PC 
Terminal : Recommended : ee 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 
23 PARAM1 User IL(r/w) Protocol specific parameters. 0..231 
to to 


30 PARAM8 


31, PARAM9 User - A20(r/w) | Protocol dependent string parameter. | Maximum 20 
46, to characters 
47, PARAM12 
48 

NOTE 


The C1538 submodule must always be restarted if the references ina MVICHAN 
element are changed. It is not enough to just change the values. 
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Figure 3-17. LINESTAB and CARRDEL in Half Duplex Mode 
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Figure 3-18. Turn-around Time 
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3.5.7.2 MVINODE Data Base Element 


Every node on a MVI local control network is represented by a data base element of type 
MVINODE. The element specifies: 


° In master mode: Each slave node on the bus is represented by one data base element. 


° In slave mode: Only one data base element representing the slave node view of the master 
node is needed. 


The maximum number of MVINODE elements that one MVI channel can handle is 32. 


MVN1 


MVI Node 
(357.1) 


S1_] Base part 


$2) Status 1 (1-16) 


$3.4 Status: 1. (17-32) 


S4_ Status 2+3 


VALUE |— VAL 
—| NAME VALUE2 |— VAL 
—| ACT VALUE3 |— VAL 
— NET VALUE4 |— VAL 
—| REMNODE VALUES |— VAL 
— NODETYPE VALUE6 |— VAL 
—| STRINGIA VALUE7 |— VAL 
— STRING1B VALUES |— VAL 
—| STRING2A VALUE9 [|— VAL 
—| STRING2B VALUE10 |— VAL 
— STRING3A VALUE11 [-— VAL 
—| STRING3B VALUE12 |— VAL 
— STRING4A VALUE13 [— VAL 
— STRING4B VALUE14 |— VAL 
—| STRINGSA VALUE15 |— VAG STATUS 2 = 
— STRING5B VALUE16 |— VAL STATUS3 |— 
Base part Status 1 (1-16) Status 1 (17-32) Status 2+3 


Figure 3-19. Overview of MVINODE Data Base Element 
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Figure 3-20. Data Base Element MVINODE Base Part for MVI Protocol 


Table 3-7. Terminal Description for MVINODE Base Part 


Terminal Value Recommended oe 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 
1 NAME User MVNx = Unique module NAME. Maximum 20 
characters. 
2 ACT User 1 B(r/w) O=the element is spare - 
1=the element is ACTive 
3 NET User 1 = NETwork number of remote node. 0..9 
4 REMNODE User 1 I(r/w) REMote NODE number. 0..99 
5 NODETYPE User 0 I(r/w) Remote NODETYPE. 0..32767 
6 STRING1IA User - A20(t/w) These parameters are used for node | Maximum 20 
specific configuration parameters that | characters. 
are needed by the protocol handler. 
; ; ‘ . For example, if the protocol supports | - 
15 STRING5B User ~ A20(r/w) dialed-up lines the dial-up command Or) Maximum 20 
phone number(s) could be specified | characters. 
here. 
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Figure 3-21. Status I (1-16) / Status 1 (17-32) 


Status1 


Contains information required for flow control, among other things, see Table 3-8, below. 
Value9 - Value32 can be used for protocol specific status information. 
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Table 3-8. Statusl 


Terminal 
No. 


Terminal Name 


Value 
entered 
by 


Recommended 
Value 


Connection 
Data Type 


PC 


Description 


Remarks 


17 


VALUE 


System 


B(r) 


Link status 
The corresponding PLC reachable, 
see Figure 3-32 


Set to “1” when the remote node is 
reachable. 

Set to “O” when contact with remote 
node is lost (including restart of 
C1538). 


The master considers the contact lost 
after maximum number of 
retransmissions without an answer. 
The slave node considers the contact 
lost when the time between 
messages from the master exceed 
the poll cycle time. 


Slave and 
master 


18 


VALUE2 


System 


Reserved. 


19 


VALUE3 


System 


Reserved. 


20 


VALUE4 


System 


Reserved 


Master 


21 


VALUES 


System 


Reserved 


Master 


22 


VALUE6 


System 


Ready for Message 

Set to “1” when no command is 
pending, from the application to the 
PLC. 

Set to “O” when a command is 
pending, from the application to the 
PLC. Used by the PC program for 
flow control, see Figure 3-32. 


Master 


23 


VALUE7 


System 


Reserved. 


Master 


24 


VALUE8 


System 


Reserved. 


Master 


25 
to 
48 


VALUE9 
to 
VALUE 32 


System 


User defined. 


Master 
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— sl 


— ee 


—— $3: 


MVN1 


MVI Node 


(25 fe) 


Base part 


Status 1 (1-16) 


Status 1 (17-32) 


STATUS2 | 49 
STATUS3 |_ 50 


Figure 3-22. Status 2+3 


Status2 and Status3 (Integer Long) 


Status2 and Status3 can be used for protocol specific status information. See Table 3-9. 


Table 3-9. Status2 + Status3 (Integer Long) 


Terminal Value Recommended Ee 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 
49 Status 2 System | - IL(r/w) User defined o-29! 
50 Status 3 System | - IL(r/w) User defined o2 29! 
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3.5.7.3 MVI Data Block Element (MVB) 


The MVI Data Block element specifies either data transmission to other MVI nodes or 
commands sent locally to the protocol handler on the MVI submodule. When used for data 
transmission, the MVB data base element on the sending side both specifies a command and 
holds the data for transmission. On the receiving side, the MVB data base element just holds the 


data. 
MVB1 

+ NAME VALID L MVI Data Block 
+ IDENT ERR + (358.1) 
+ NET 
— REMNODE ~=. sl Base part 1 
+ SOURCE 
— ACT S2 + Base part 2 
+ BLOCKED 
— SCAN_FTR S3 + Value ref. 1-16 

Base part 1 s4 -| value ref. 17-32 

s5 ~Value ref. 33-48 

_] empcopE s6é Value ref. 49-64 
—| AUXINFO1 a 2 
_| aUXINFO2 Ss7 - Value ref. 65-80 
—| AUXINFO3 z 
_] REGADDR sg - Value ref. 81-96 
—| NOOFREGS | = 
ates L Ss9 Value ref. 97-112 
—| BITREF $10 + Value ref. 113-128 
—| NO_BREC 
—| NO_INT 
—| NO_LINTL 
—| NO_REAL 

Base part 2 

ye 
| REF1 Value ref. 17-32 _| REF113 
+ REF2 _| REF114 
4 REF3 -| REF115 
_| REF4 Value ref. 33-48 _| REF116 
~ REFS -| REF117 
— REF6 -| REF118 
4 REF7 Value ref. 49-64 _| REF119 
—| REF8 -| REF120 
| REF9 _| REF121 
+ REF10 Value ref. 65-80 _| REF122 
4 REF11 _| REF123 
— REF12 —| REF124 
— REF13 Value ref. 81-96 -| REF125 
| REF14 _| REF126 
4 REF15 _| REF127 
+ REF16 Value ref. 97-112 —| REF128 
Value ref. 1-16 Value ref. 113-128 


Figure 3-23. Overview of MVB Data Base Element 
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(node) of the receiving RTU. 
REMNODE must be the same as in the 
corresponding MVINODE. 


Base Part 1 
MVB1 
MVI Data Block 
(358.1) 
MVB1 1 —-| NAME VALID |_ 18 — 
) 3 | IDENT ERR |— 24 — 
1 20 _| NET 
1 21 —| REMNODE 
RECEIVE 17 —| SOURCE 
) 2 —| ACT 
1 19 —| BLOCKED 
4 22 -| SCAN_FTR 
S2 Base part 2 
S3 Value ref. 1-16 
S4 Value ref. 17-32 
s5 Value ref. 33-48 
S6 -|Value ref. 49-64 
S7 Value ref. 65-80 
S8 Value ref. 81-96 
$9 Value rer. 87S112 
$10 + Value ref. 113-128 
Figure 3-24. MVB Base Part 1 
Table 3-10. Terminal Description of MVB for Base Part 1 
Terminal value Recommended oe 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 
1 NAME User MVBx = Unique module NAME. Maximum 20 
characters. 
3 IDENT User - = IDENTity. A number which must be 1..255 
unique for a combination of NET and 
REMNODE. 
20 NET User - — NETwork number. Defined at the 1.9 
MVIMOD data base element for the 
C1538. 
21 REMNODE User - _ REMote NODE number. RTU number | 1..99 


3-94 


3BSE 015 373R0001 


MultiVendor Interface - Protocol Development Kit Advant® Controller 400 Series User’s Guide 
Section 3.5.7 Protocol Configuration and Application Building for Advant Controller 400 


Table 3-10. Terminal Description of MVB for Base Part I (Continued) 


7 Value PC 
Terminal : Recommended . pbs 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 
17 SOURCE User RECEIVE - SOURCE. Direction of the data - 


transmission. 
RECEIVE = Receiving MVB 
SEND = Sending MVB 


2 ACT User 1 B(r/w) Element is ACTive. = 
0 = Element is spare 
1 = Element is active 


19 BLOCKED User 1 B(r/w) BLOCKED. Cyclic execution of the |The cycle 
specified command is: time is 
0 = Not blocked defined by 
1 = Blocked the terminal 
SCAN_FTR. 
22 SCAN_FTR User 4 - SCAN FacToR. 1..127 


In multiples of basic scan cycle time 
(default 1 second). 


18 VALID System | — B(r/w) VALID - 
SOURCE = SEND: 

Set to 1 after the first execution of 
MVB. 

SOURCE = RECEIVE: 

Set to 1 after reception of DATs. 

The terminal will be reset by the 
system if no DATs are received within 
the supervision time of 3*SCAN_FTR 
basic scan cycle time. 


24 ERR System | — B(r) ERRor. Set if an error occurred. = 
AC 400 sends a system message to 
indicate the nature of the problem. 

0 = No error 

1 = Error 
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Base Part 2 


NOT DEFINED 


n 
PP 
| 


MVB1 


MVI Data Block 


(358.1) 


Base part 1 


oooocooco°c°o 


OPPWNODNUO BROW D 


CMDCODE 
AUXINFO1 
AUXINFO2 
AUXINFO3 
REGADDR 
NOOFREGS 
DATREF 
BITREF 
NO_BREC 
NO_INT 
NO_INTL 
NO_REAL 


n 
w 


n 
Ps 


Value ref. 


1-16 


Value ref. 


L732 


n 
ao 


Value ref. 


33-48 


Sé 


S7 


Value ref. 


49-64 


Value ref. 


65-80 


S8 


Value ref. 


81-96 


sg 


Value ref. 


S71 112 


S10 


Value ref. 


113-128 


Figure 3-25. MVB Base Part 2 
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Table 3-11. Terminal Description of MVB for Base Part 2 


Terminal value Recommended de 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 


6 CMDCODE User - - CoMmanD CODE to be executed. See also 
Table 3-2 


Control (Local) Commands: 
RESTART HANDLER - Restart 
protocol handler 

RESET DIAGNOSTICS -— Reset 
diagnostics data 

DIAL STATION — Make a dial-up to a 
node 

HANGUP LINE — Hang-up a telephone 
line 

GET DIAGNOSTICS — Get diagnostics 
data 

SET TRACE MODE - Set trace mode 
TIME SYNCH - Activate time 
synchronization 


Read Commands: 

READ | -— Read 16bit integer register(s) 
READ IL — Read 32bit integer 
register(s) 

READ B - Read boolean register(s) 
READ R — Read real value register(s) 
READ C — Read a string 

READ MIX L — Read mixed (32bit) 
register(s) 


Write Commands: 

WRITE | — Write 16bit integer 
register(s) 

WRITE IL — Write 32bit integer 
register(s) 

WRITE B — Write boolean register(s) 
WRITE R — Write real value register(s) 
WRITE C — Write a string 

WRITE MIX L — Write mixed (32bit) 
register(s) 


9 AUXINFO1 User - IL(r/w) AUXiliary INFOrmation 1 Que?! 

This information can be used inthe | Only used in 
Protocol Handler to distinguish master 
between several protocol function mode. 
codes where the command code is 
identical. 
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Table 3-11. Terminal Description of MVB for Base Part 2 (Continued) 


: Value PC 
Terminal . Recommended ‘ a 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 
10 AUXINFO2 User - IL(r/w) AUXiliary INFOrmation 2 0.291 
This information can be used inthe | Only used in 
Protocol Handler to distinguish master 
between several protocol function mode. 
codes where the command code is 
identical. 
11 AUXINFO3 User au A20(r/w) | AUXiliary INFOrmation 3 Maximum 20 
This information can be used inthe __| characters. 
Protocol Handler to distinguish 
between several protocol function 
codes where the command code is 
identical. 
4 REGADDR User - REGister start ADDRess. O27" 
First register address to be transferred. 
See section “Register Address Usage“ 
below. 
5 NOOFREGS _ | User I(r/w) NO OF REGisterS. 0..231 
Number of registers to be transferred. 
See Register Address Usage in this 
section below. 
7 DATREF User 0 I(r/w) DAT REFerence in this element 0..110 or 
(max 110 for BREC, INTL or REAL, /|0..128 
128 for INT DATs). 0 indicates 
See Register Address Usage inthis _| that the 
section below. terminal is 
not used. 
Only used in 
master 
mode. 
8 BITREF User 0 I(r/w) BIT REFerence in the above selected | 0..32 
DAT. 0 indicates 
See Register Address Usage in this__| that the 
section below. terminal is 
not used. 
Only used in 
master 
mode. 
12 NO_BREC User - Number Of Boolean RECords DAT(B),| 0..110 
This is dependent on which 
CMDCODE that is chosen for the 
MVB. If a READ B command is to be 
executed, boolean records are of 
course necessary. 
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Table 3-11. Terminal Description of MVB for Base Part 2 (Continued) 


Terminal 
No. 


Terminal Name 


Value 
entered 
by 


Recommended 
Value 


PC 
Connection 
Data Type 


Description 


Remarks 


13 


NO_INT 


User 


Number Of INTeger records DAT(I). 
This is dependent on which 
CMDCODE that is chosen for the 
MVB. If a READ | command is to be 
executed, integer records are of 
course necessary. 


0..128 


14 


NO_INTL 


User 


Number Of INTeger Long records 
DATI(IL). 

This is dependent on which 
CMDCODE that is chosen for the 
MVB. If a READ IL command is to be 
executed, integer long records are of 
course necessary. 


0..110 


15 


NO_REAL 


User 


Number Of REAL records DAT(R). 
This is dependent on which 
CMDCODE that is chosen for the 
MVB. If a READ R command is to be 
executed, real records are of course 
necessary. 


0..110 
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MVB1 


MVI Data Block 
(358.1) 


Sl + Base part 1 


S2 + Base part 2 


REF 1 
REF 2 
REF3 
REF 4 
REF 5 
REF 6 
REF 7 
REF 8 
REF 9 
REF 10 
REF 11 
REF 12 
REF 13 
REF 14 
REF15 
REF 16 


Oy OVO COs OF EAL Eee Ee 


PRPRPRPRER 


lue ref. 17-32 


Wn 
ww 
! 
< 
i) 


lue ref. 33-48 


n 
a 
! 
< 
o 


lue ref. 49-64 


n 

o 
! 
< 
o 


S7 4 Value ref. 65-80 


sg + Value ref. 81-96 


S9 +Value ref. 97-112 


810 + Value. ret. 213-128 


Figure 3-26. Value Reference 1-16 


The value references 17-128 are analogous to Value reference 1-16 


Table 3-12. Terminal Description for MVB Value Reference I - 128 


: Value PC 
Terminal , Recommended 2 fs 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 
16(1) REF 1 User - - REFerence: Name of connected | If an MVB has 
DAT element (number 1). the name 
"MVB1” and 
16(2) REF2 User - - REFerence: Name of connected |NO BREC or 
DAT element (number 2). NO_INT has the 
value 1, the 
; name of the 
REFerence: Name of connected | connected DAT 
16(128) | REF128 User : i DAT element (number 128). elements will be: 
MVB1.B1 or 
MVB1.11 
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Command Code Usage 


The CMDCODE terminal of the MVB data base elements, describes together with the 
AUXINFO1, AUXINFO2, and AUXINFO3 terminals the MVI Protocol function code. 


Register Address Usage 


The MVB data base element terminals REGADDR, NOOFREGS, DATREF and BITREF are 
used together to address all or part of the references held by a MVB data base element. 


The terminal REGADDR is the address for the register held by the first DAT reference to an 
INT DAT or the first register (VALUE) of the first DAT reference to a BREC DAT. 


The terminal NOOFREGS is the number of registers to read or write. NOOFREGS=0 (zero) is 
not allowed for a MVB data base element that is used for sending a command. 


The terminal DATREF is the index of the first DAT reference to be read or written. DATREF=1 
refers to the first DAT references of the MVB data base element. DATREF=0 indicates that this 
terminal is not used. 


The terminal BITREF is the index of a boolean register (bit) within a BREC DAT. BITREF=1 in 
a MVB data base element which is configured for BREC DATs, refers to the first boolean 
register (VALUE) of the addressed BREC DAT. BITREF=0 indicates that this terminal is not 
used. 


NOTE 


NOOFREGS, DATREF and BITREF are only relevant for a MVB data base 
element which is used for sending a command to a node on the communication 
link. If BITREF is used, DATREF must also be used. 
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3.5.7.4 Data Transfer 
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The MVB data base element is used for transfer of data between nodes. It is used either to send 
a command and hold the data or only to hold the data. For a MVB data base element which is 
used to send a command, BLOCKED could be | or 0. If BLOCKED=1, the command is not 
sent cyclically and can be sent event driven by using the SENDREQ PC element. If 
BLOCKED-=0 (zero), the command will be sent cyclically with a cyclicity of the basic scan 
cycle time (default 1 second) x SCAN_FTR. For a MVB data base element which is only used 
to hold data, BLOCKED should always be set to 1. 


ACT is used to activate/deactivate a MVB data base element. If ACT=0 (zero). The MVB data 
base element is deactivated and is considered to be spare in the data base. The MVB data base 
element is not sent and/or updated. If ACT=1 the MVB data base element is activated. The 
MVB data base element could be sent and/or updated. 


Read/Write Commands 


For each of the Data Transfer (Read/Write) Commands, its name in the host (1.e. what you write 
into the CMDCODE terminal in the MVB) and the corresponding value when seen in the 
Protocol Handler are listed. See Table 3-13. 


For some of them, the translation between the Data Base and the Protocol Handler differ 
according to the number of registers that are to be handled. 


Table 3-13. Read/Write Commands that can be Used 


CMDCODE (in MVB) | NOOFREGS (in MVB) ps eras 
READ | “4 MviRdSnglint16 
>I MviRdMultint16 
READ IL =1 MviRdSnglint32 
>I MviRdMultint32 
READ B Si MviRdSnglBool 
>1 MviRdMultBool 
READ R 4 MviRdSnglFloat 
> MviRdMultFloat 
READ C =1 MviRdString 
READ MIX L <any number> MviRdMix32 
WRITE | =i MviWrSnglintt6 
>1 MviWrMultInt16 
WRITE IL sit MviWrSnglint32 
>1 MviWrMultInt32 
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Table 3-13. Read/Write Commands that can be Used (Continued) 


CMDCODE (in MVB) | NOOFREGS (in MVB) sure Bu Aaa 
WRITE B =1 MviWrSngIBool 
>1 MviWrMultBool 
WRITE R =1 MviWrSngIFloat 
>1 MviWrMultFloat 
WRITE C =1 MviWrString 
WRITE MIX L <any number> MviWrMix32 


NOTE 


The MVI Protocol Handler Interface commands MviRdString and MviWrString 
are currently not supported. 


Example 1: Advant Controller 400 Reads One INT from a Remote Node 


Consider the communication between an Advant Controller 400 and a remote node where the 
Advant Controller 400 wants to read one INT from the remote node. A MVB data base element 
will be used where CMDCODE= READ I, AUXINFO1=0, AUXINFO2=0, NOOFREGS=1 
and SOURCE=RECEIVE. 


MB_FC3 —~/ NAME VALID }— 

1 ——) IDENT ERR }— 

9 NET 

2 ——| REMNODE 

RECEIVE ——) SOURCE 

il — ACT 

0 ——] BLOCKED 

4 ——)| SCAN_FTR 

READ I ——| CMDCODE 

0 ——| AUXINFO1 

0 ——| AUXINFO2 
——| AUXINFO3 

4001 — REGADDR 

1 — NOOFREGS 

0 ——] DATREF 

0 ——] BITREF 

0 —] NO_BREC 

1 ——] NO_INT 

0 ——| NO_INTL 

0 ——)], NO_REAL 

REF 1 


Figure 3-27. Advant Controller 400 Reads One INT from a Remote Node 
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Example 2: Advant Controller 400 Writes One INT to a Remote Node 


Consider the communication between an AC400 and a remote node where the AC400 wants to 
write an INT to the remote node. A MVB data base element will be used where CMDCODE= 
WRITE I, AUXINFO1=0, AUXINFO2=0, NOOFREGS=1 and SOURCE=SEND. 


MB_FC16 


NO_REAL 


REF 1 


Figure 3-28. Advant Controller 400 Writes One INT to a Remote Node 
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Example 3: Advant Controller 400 Writes the Last Ten INT References to a 
Remote Node 


DATREF can be used to address part of the references in the command MVB DB-element, see 
Figure 3-29. In this example, AC400 writes the last 10 INT references, corresponding to register 
address 4011-4020, to the remote node. A MVB data base element will be used where 
CMDCODE= WRITE I, AUXINFO1=0, AUXINFO2=0, NOOFREGS=10, DATREF=11 and 
SOURCE=SEND. 


MB_FC16 ——! name VALID | — 
1 ——| IDENT ERR }— 
9 —| NET 
2 —J| REMNODE 
SEND —| SOURCE 
1 —| ACT 
0 —| BLOCKED 
4 —| SCAN_FTR 
WRITE I ——| CMDCODE 
0 —| AUXINFO1 
0 —] AUXINFO2 
—| AUXINFO3 
4001 —| REGADDR 
10 —| NOOFREGS 
11 —| DATREF 
0 —| BITREF 
0 —]| NO_BREC 
20 ——) NO_INT 
0 —]| NO_INTL 
0 —) NO_REAL 
REF 
REF 9 


ys) 
ie 
Lex] 
peeve tien Ufepetry ings Wipe, rainy, ||| vets tin |e 
oO |o JY In |O [BR Jw IY JR Jo 


REF20 


Figure 3-29. Advant Controller 400 Writes the Last Ten INT References to the Remote Node 
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Example 4: Advant Controller 400 Writes the Last Ten Boolean Registers of the 
11th Reference to the Remote Node 


BITREF can be used to address certain boolean values (bits) of a reference in the command 
MVB data base element, see Figure 3-30. In this example, AC400 writes the last 10 boolean 
registers (bits) of the 11th reference, corresponding to register address 343-352, to the remote 
node. A MVB data base element will be used where CMDCODE= WRITE B, AUXINFO1=0, 
AUXINFO2=0, NOOFREGS=10, DATREF=11, BITREF=23 and SOURCE=SEND. 


MB_FC15 —] NAME VALID |_— 
1 —| IDENT ERR |— 
9 ——| NET 
2 —J| REMNODE 
SEND —J| SOURCE 
1 — ACT 
0 —J| BLOCKED 
4 —| SCAN_FTR 
WRITE B —| CMDCODE 
0) ——J] AUXINFO1 
0 —]| AUXINFO2 
——| AUXINFO3 
1 —| REGADDR 
10 ——| NOOFREGS 
11 —| DATREF 
23 —) BITREF 
20 ——J| NO_BREC 
0) —]| NO_INT 
0 —] NO_INTL 
0) —] NO_REAL 
REF 1 
VALUE 
gag 
REF11 
REF12 
REF19 
REF20 


Figure 3-30. Advant Controller Writes the Last Ten Boolean Registers of the Reference to a 
Remote Node 


Special considerations when handling Strings and Mixed Registers 


When using the command codes handling strings (READ C and WRITE C) it is NO_INT that 
has to be used to get the necessary DATs. These integer records can then be used to handle, for 
example, the ASCII code for one or several characters. 


For mixed registers (READ MIX L and WRITE MIX L), just choose the mix of records 
(NO_BREC, NO_INT, NO_INTL, NO_REAL) that is desired. 
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3.5.7.5 MVBs used for Control Commands 


3BSE 015 373R0001 


This section describes the use of the MVB data base element for Control Commands directed to 
CI538 itself in master and slave mode. 
It also contains the three commands concerning sending special commands to a PLC/RTU. 


How to handle these commands must of course be implemented in the Protocol Handler. This is 
merely a list over which commands that can be transferred from the AC400 host to the Protocol 
Handler. With each command, three AUXINFO values can be sent to separate between different 
variants on the same command. 


The commands are actually handled directly in the Host Interface: RESET DIAGNOSTICS, 
GET DIAGNOSTICS, and SET TRACE MODE. Even though they are handled automatically in 
the host interface they still need some support in the Protocol Handler. 


Control Commands handled in the Host Interface 


These Control Commands are taken care of in the Host Interface. But to get interesting 
diagnostics, the DiagInfo struct must of course be updated in the Protocol Handler, and turning 
on a trace mask implies that there are trace messages in the Protocol Handler code. 


Table 3-14. Control Commands that are handled in the Host Interface. 


CMDCODE (in MVB) AUXINFO1 
RESET DIAGNOSTICS Not used. 
GET DIAGNOSTICS Not used. 
SET TRACE MODE Contains the trace mask. 


Control Commands 


For each of the Control Commands, its name in the host (i.e. what you write into the 
CMDCODE terminal in the MVB) and the corresponding value when seen in the Protocol 
Handler are listed. See Table 3-15. 


Table 3-15. Control Commands that can be Used. 


CMDCODE (in MVB) Name in Protocol Handler 
RESTART HANDLER MviRestartHndl 

DIAL STATION MviDialStation 
HANGUP LINE MviHangupLine 
TIME SYNCH MviTimeSynch 
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3.5.7.6 PC Program Layout 


To control the data flow on the asynchronous communication link, you must build a PC program 
in the Advant Controller 400. The PC program receives status information from CI538. The 
flow control is maintained through a chain of SENDREQ PC elements, each corresponding to a 
Command data base element to be transmitted (see Figure 3-32). 


Include all SENDREQ PC elements with Command data base element addressed to the same 
PLC in the same chain to ensure a correct flow control to the MVI Protocol link. Use the PC 
program to control the Command MVB data base element if CI538 is used in master mode. A 
PC program is not necessary in slave mode. 


The cycle time of CONTRM should be approximately 100 ms. 


Sequence for 


PLC1 
clei apa See Figure 3-32 
Event Pp SENDREQ 
driven > SENDREQ 
logic — SENDREQ 
SENDREQ 
ip : a SENDREQ 
activate a 
the 
transmission 
° : Sequence for 
mS CONTRM PLC2 
See Figure 3-32 
> SENDREQ 
PP SENDREQ 
SENDREQ 
“a SENDREQ 
< SENDREQ 
Sequence for 
CONTRM PLCn 
See Figure 3-32 
oe SENDREQ 
pe SENDREQ 
— SENDREQ 
SENDREQ 
= SENDREQ 


Figure 3-31. Overall PC Program Layout for MVI Protocol in Master Mode 
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Type Circuits for MVI Protocol Data Flow Control 


Figure 3-32 shows a PC program type circuit which is used for data flow control on a MVI 
Protocol link. By linking several SENDREQ PC elements to each other with NXTBLK and 
PRVBLK, the order in which the MVB data base elements are activated can be controlled. By 
using Link Status and Ready for Message status bits from the MVINODE data base element to 
control the BLOCK terminal on the SENDREQ element, it can be assured that the CI538 
submodule does not receive more messages than it can handle. 


When ACT goes from 0 to 1, the MVB data base element with the identity given by NET, 
NODE and IDENT is activated once. 


NXTBLK is true when sending of an MVB is in progress. When sending is completed, it is set 
to false. When no sending is in progress, NXTBLK follows the value of PRVBLK. 


PRVBLK is used together with NXTBLK to control the activation of the MVB data base 
elements. No sending begins when PRVBLK is true. If sending orders are given at the ACT 
terminal during blocking by PRVBLK, the MVB will be activated when PRVBLK is set to false. 


No sending takes place when BLOCK is true. If sending orders are given at the ACT terminal 
during blocking by BLOCK, they are ignored. 


Flow control of activation of MVB data base elements is achieved by connecting the NXTBLK 
output of the first SENDREQ element to the PRVBLK input of next SENDREQ element. The 
NXTBLK output of this element is then connected to the PRVBLK input of the third 
SENDREQ element and so on. The NXTBLK output of the last SENDREQ element is 
connected to the PRVBLK input of the first SENDREQ element. Thus, the SENDREQ elements 
are connected in a chain, see Figure 3-32. With this PC program sequence, each SENDREQ 
element will activate its MVB data base element, one for each execution cycle, in the order they 
are linked together. 
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CONTRM 
SENDREQ (4,0,1) 
Puls to Activate SACT — 
data base element “ 
D=1 —4 NET Read 
{ D=10 —] nopg data 
(from MVINODE data base element) ) Command MVB IDENT 
IDENTity 
Link status & BLOCK NXTBLK [}—— 
Ready for Message PRVBLK | 
SENDREQ (4,0,1) 
Puls to Activate ae 
data base element BUSY 
D=1 —I ner “Write 
D=10 1 nopE data” 
pommand | +pmnt 
IDENTity 
BLOCK NXTBLK t— 
PRVBLK 
SENDREQ (4,0,1) 
Puls to Activate Sa 
data base element BUSY 
D=1 NET “Preset 
D=10 NODE multiple 
Command registers” 
MVB __| IDENT 
IDENTity 
BLOCK NXTBLK 
J) 6 PRVBLK 


1) Status is fetched from the MVINODE data base element 
for the PLC (in this example node=10), see Section 3.5.7.2, MVINODE Data Base Element 
Ready for Message = MVN1:VALUE6 
Link status = MVN1:VALUE 


Figure 3-32. PC Program Sequence for Control of MVI Protocol in Master Mode 
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4.1 Operating Overview 


Advant Controller 400 must be in operation mode (mode P1, indicated on the front of the main 
processor module) to communicate on the MVI link. With Advant Controller 400 in 
configuration mode (mode P2, indicated on the front of the main processor module), the 
communication is stopped. 


After start-up, and with Advant Controller 400 in operation mode, you can perform the 
following operations: 


° From the PC program for activation of commands and flow control 


—  Activate/Stop sending of MVB data base element (Read, Write and Status Request 
command). 


—  Re-initiate a channel on the CI538 submodule by sending a restart handler command. 


— Restart the CI538 submodule by setting/re-setting the terminal SERVICE on the 
MVIMOD data base element. 


° The status information for a node on the MVI link in corresponding MVINODE data base 
element can be displayed. 


4.2 Runtime Tutorial 


A Runtime Tutorial is not included in this manual. The user must be familiar with application 
commands in Advant Controller 400. 


4.3 Operating Instructions 


For a description of commands for control of the PC program and data base, please refer to 
AMPL Configuration Advant Controller 400 Series Reference Manual. 
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Chapter 5 Maintenance 


5.1 Preventative Maintenance 


Check the stack usage for the tasks comprising the protocol implemented during runtime. To do 
this, use the command checkStack from the Tornado Shell, or use the Tornado browser to view 
stack usage. 


For example: 


-> checkStack tMviHdl101 


NAME ENTRY TID SIZE CUR HIGH MARGIN 


tMviHdl0l _mviXYMain 23e1c78 10000 832 3968 6032 


where the different entities are: 


NAME - task name. 

ENTRY- task entry point, i.e., the main function. 
TID - task identity. 

SIZE - the total stack size. 

CUR - the current number of stack bytes used. 
HIGH - the maximum number of stack bytes used. 


MARGIN - the number of bytes never used at the top of the stack (SIZE - HIGH). 


The margin should not be less than 25 percent of the total stack size during normal operation. 


If you do not achieve an acceptable margin you can modify how much stack each protocol 
handler task is given. This is done by modifying the spawnProtHandlers.c file in your 
development directory. Find the taskSpawn() line for the AC400 Host Protocol Handler and 
modify the 4th argument to the taskSpawn() function. The default value is 10000 bytes. 


5.2 Hardware Indicators 
The CI538 submodule has two LED indicators on the front: 


The green LED is lit when the Host Interface and the Protocol Handler are started on the 
CI538 submodule. To be able to achieve this, the data base element MVIMOD for the 
CI538 submodule is correctly filled in, see Section 2.2.1, Hardware (the terminal IMPL 
and SERVICE must be set to 1 on the MVIMOD element). 


The red LED is lit when a fatal error is detected on the CI538 submodule. 


See Figure 5-1 below. 
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FOO R! F — FAULT LED (RED) 
R = RUN (GREEN) 


Figure 5-1. LED Indicators on CI538 Submodule 


5.3 Error Messages 


5-2 


This part of the document lists all system messages that might be generated from the CI538 
submodule. System messages from the Advant Controller 400 system software are not included. 
The MVI data base element task CXAX000 in the Advant Controller 400, can report a number 
of errors related to the MVI communication — MVB not found, destination unreachable, channel 
to handler full and so on. 


For translation of system messages from the Advant Controller 400, please refer to the Advant 
Controller 410 User’s Guide or Advant Controller 450 User’s Guide. 


The error codes indicated on the data base element CI538 are translated in Table 5-1 below. 


Table 5-1. Error Codes from the Data Base Element MVIMOD 


aad Interpretation 
Code 
21 Duplicate node number on the network 
22 More than one node number in the station 
23 Station connected to more than one Control Network 
25 Network number already used in the Advant Controller 
31 Module not found or internal bus error 
32 Not correct hardware identity on module 
33 Start up of module failed 
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Table 5-1. Error Codes from the Data Base Element MVIMOD (Continued) 


enor Interpretation 
Code 
34 Suspected hardware error 
35 Not correct software identity on module 
36 Not correct module interface identity 
50 Illegal submodule number 
51 Illegal module position 
52 Module position number already used in the Advant Controller 
53 Two modules has the same submodule number 


System message printouts on the engineering station have the following appearance: 


Node Time Mcode 


01 23 S7* 13:25:09 29 5x Mvixxxnn 4H’00000000 H’12345678 H’12345678 


i f ff fF ff 


Netw Submodule No. Mtype Task Trace number/ Datat Data2 
Address 


Node Time Mcode 


01 23 S7* 13:25:09 29 5x HLxxxxnn  4H’00000000 H’12345678 H’12345678 


fof Wee el, edie y olka ol 


Netw Submodule No. Mtype Task Trace number/ _Datat Data2 
Address 


Node Time Mcode 


01 23 S7* 13:25:09 29 5x HLxxmmnn ~~ H’00000000 H’12345678 H’12345678 


ff ee eee eee | 


Netw Submodule No. Mtype Task Trace number/ Datat Data2 
Address 


Figure 5-2. System Message Layout 


3BSE 015 373R0001 5-3 


MultiVendor Interface - Protocol Development Kit Advant® Controller 400 Series User’s Guide 
Chapter 5 Maintenance 


All system messages have: 
«  Mtype = 29 
* Task name = MVIxxxnn 
— XXX = Hdl if the MVI Protocol Handler reports the error 
— nn=01 for port one 
—  nn= 02 for port two. 
* Task name = HLxxxxnn 
—  XXXX = Setu if the MVI Setup task reports the error 
—  XXxx = Wdog if the MVI Watchdog task reports the error 
—  XXXX = Stat if the MVI Status task reports the error 
— | XXxx = LCmd if the MVI Local command task reports the error 
—  XXxx = LRsp if the MVI Local response task reports the error 
—  XXxx = UCmd if the MVI Up stream command task reports the error 
—  XXxx = DRsp if the MVI Down stream response task reports the error 
— nn=01 for port one 
—  nn= 02 for port two. 
* Task name = HLxxmmnn 
— xx = DC if the MVI Down stream command task reports the error 
— Xx = UR if the MVI Up stream response task reports the error 
- mm = node number, a decimal value. 
— nn=01 for port one 


—  nn= 02 for port two. 


Table 5-2. Messages with Mcode = 55 and Task Name = MviHdInn from C1538 


Trace Number Parameter Description 
: 1 = data1 Comments and Suggested Actions 
(Hexadecimal) = data? 
00010002 1:- Failed to create UART device. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00010003 1: File descriptor Initiate UART failed. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
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Table 5-2. Messages with Mcode = 55 and Task Name = MviHdinn from CI538 (Continued) 


Trace Number 
(Hexadecimal) 


Parameter Description 
1 = data 


2 


= data2 


Comments and Suggested Actions 


00010004 


1: 
2: 


Failed to open UART device. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00010009 


4 


: File descriptor 


Parameterize UART failed. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


0001000b 


4 


: File descriptor 


Failed to fetch event status from UART. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


0001000d 


4 


: File descriptor 


Failed to fetch modem status from UART. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00020002 


=e 


Failed to create watchdog timer device. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00020004 


— 


Failed to open watchdog timer device. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00020010 


= 


: File descriptor 


Failed to start watchdog timer. 


Reset the MVI module, if the problem persists, please 
contact ABB. 


00040002 


= 


Failed to create FIFO device. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00040004 


= 


Failed to open FIFO device. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00040005 


— 


: File descriptor 


Read from FIFO failed. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00040006 


— 


: File descriptor 


Write to FIFO failed. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


0005000f 


1: 
2: 


Requested block size 


Failed to allocate memory. 
Reset the MVI module, if the problem persists, please 
contact ABB. 
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Table 5-2. Messages with Mcode = 55 and Task Name = MviHdinn from CI538 (Continued) 


Tace Number Parameter Description 
: 1 = data1 Comments and Suggested Actions 
(Hexadecimal) 9 = data2 
00050012 1:- Select failed. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00060013 1: Node number Illegal node number. The node number requested was not 
2: - configured. 
Check the configuration and command data base 
elements. 


Table 5-3. Messages with Mcode = 56 and Task Name = HLSetunn from CI538 


Thace:Number Parameter Description 
: 1 = data1 Comments and Suggested Actions 
(Hexadecimal) 
2 = data2 
00020002 1:- Failed to create a watchdog timer. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030002 1:- Failed to create a transceiver channel. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030004 1:- Failed to open transceiver channel. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030005 1: File Descriptor Failed to read from the transceiver channel. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030006 1: File Descriptor Failed to write to the transceiver channel. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030007 1: File Descriptor Failed to close a transceiver channel. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
0003000f 1: Block size Failed to allocate transceiver buffer 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030016 1: - Failed to get host information. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
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Table 5-3. Messages with Mcode = 56 and Task Name = HLSetunn from CI538 (Continued) 


Trace Number Parameter Description 


. 1 = data1 Comments and Suggested Actions 
(Hexadecimal) 3 = datad 
00030023 1: Buffer pointer Received illegal pointer from the Transceiver Interface. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00040004 1:- Failed to open FIFO pipe device to the protocol handler. 
2: - Reset the MVI module, if the problem persists, please 


contact ABB. 


4 


00040024 : File Descriptor 


2:- 


loctl on the FIFO pipe failed. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


0005000f : Requested block size 


Ph — 


Failed to allocate memory. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


— 
' 


0005001f 


Failed to spawn a task. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


= 


00050025 : Task Id 


2:- 


Failed to delete a task. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


=e 
' 


00050026 


Failed to create a semaphore. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00050027 : Semaphore ld 


php 


Failed to delete a semaphore. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00050028 : Semaphore ld 


hp — 


Failed to take a semaphore. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00070015 1: DSX mcode number 
2:- 


Received illegal DSX signal from the Host. 
Reset the MVI module, if the problem persists, please 
contact ABB. 
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Table 5-4. Messages with Mcode = 56 and Task Name = HLStatnn from CI538 


Trace Number Parameter Description 
: 1 = data1 Comments and Suggested Actions 
(Hexadecimal) 
2 = data2 
0003000f 1: Block size Failed to allocate transceiver buffer. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030006 1: File descriptor Failed to write to the transceiver channel. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030016 1:- Failed to get Host information. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00040004 1:- Failed to open FIFO pipe device to protocol handler. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00050028 1: Semaphore ld Failed to take semaphore. 
2: Node number If this is reported during restarts of the protocol handler, 
ignore it, else contact ABB. 
00080023 1: Status Info pointer Received illegal pointer from the protocol handler. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00080013 1: Node number The node number in the status information received from 
2: - protocol handler is not valid. 
Reset the MVI module, if the problem persists, please 
contact ABB. 
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Table 5-5. Messages with Mcode = 56 and Task Name = HLWdognn from CI538 


Tidce: Number Parameter Description 
. 1 = datai Comments and Suggested Actions 
(Hexadecimal) 
2 = data2 
0003000f 1: Block size Failed to allocate transceiver buffer. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030006 1: File descriptor Failed to write to the transceiver channel. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030016 1:- Failed to get Host information. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00040004 1:- Failed to open FIFO device 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030004 1:- Failed to open transceiver channel. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00080023 1: Watchdog Info pointer Received illegal pointer from the protocol handler. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
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Table 5-6. Messages with Mcode = 56 and Task Name = HLLCmdnn from CI538 


Trace Number Parameter Description 
: 1 = data1 Comments and Suggested Actions 
(Hexadecimal) 
2 = data2 
0003000f 1: Block size Failed to allocate transceiver buffer. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030004 1:- Failed to open transceiver channel. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030005 1: File Descriptor Failed to read from the transceiver channel. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030006 1: File Descriptor Failed to write to the transceiver channel. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030016 1:- Failed to get Host information. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030023 1: Buffer pointer Received illegal pointer from the Transceiver Interface 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00040004 1:- Failed to open FIFO device 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
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Table 5-7. Messages with Mcode = 56 and Task Name = HLLRspnn from C1538 


Tidce: Number Parameter Description 
. 1 = data1 Comments and Suggested Actions 
(Hexadecimal) 
2 = data2 
0003000f 1: Block size Failed to allocate transceiver buffer. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030006 1: File Descriptor Failed to write to the transceiver channel. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030016 1:- Failed to get Host information. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00040004 1:- Failed to open FIFO device 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00080023 1: Response pointer Received illegal pointer from the protocol handler. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
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Table 5-8. Messages with Mcode = 56 and Task Name = HLDCmmnn from CI538 


Trace Number Parameter Description 
: 1 = data1 Comments and Suggested Actions 
(Hexadecimal) 
2 = data2 
0003000f 1: Block size Failed to allocate transceiver buffer. 
2: Node number Reset the MVI module, if the problem persists, please 
contact ABB. 
00030005 1: File Descriptor Failed to read from the transceiver channel. 
2: Node number Reset the MVI module, if the problem persists, please 
contact ABB. 
00030006 1: File Descriptor Failed to write to transceiver channel. 
2: Node number Reset the MVI module, if the problem persists, please 
contact ABB. 
00030016 1:- Failed to get Host information. 
2: - Check the configuration and command data base 
elements. 
00030023 1: Buffer pointer Received illegal pointer from Transceiver interface. 
2: Node number Reset the MVI module, if the problem persists, please 
contact ABB. 
0005000f 1: Requested block size Failed to allocate memory. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00050028 1: Semaphore Id Failed to take semaphore. 
2: - If it appears during protocol handler restart ignore it, else 
please contact ABB. 
0006002b 1: Error number Unexpected exception encountered. 
2: Node number Reset the MVI module, if the problem persists, please 
contact ABB. 
0007002a 1: Node number Received more than allowed number of commands from 
2: - the Host. 
Reset the MVI module, if the problem persists, please 
contact ABB. 
00090013 1: Node number Illegal node number. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
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Table 5-9. Messages with Mcode = 56 and Task Name = HLDRspnn from CI538 


Tidce: Number Parameter Description 
. 1 = data1 Comments and Suggested Actions 
(Hexadecimal) 
2 = data2 
0003000f 1: Block size Failed to allocate transceiver buffer. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030006 1: File Descriptor Failed to write to transceiver channel. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030016 1:- Failed to get Host information. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00040004 1:- Failed to open FIFO pipe to the Protocol Handler. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00050028 1: Semaphore ld Failed to take node mutex semaphore. 
2: Node number If it appears during protocol handler restart ignore it, else 
please contact ABB. 
00080013 1: Node number Illegal node number in the down stream response from the 
2: - protocol handler. 
Reset the MVI module, if the problem persists, please 
contact ABB. 
00080023 1: Response pointer Received illegal pointer from the protocol handler. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
0008002c 1: Node number Unknown response from the protocol handler. 
2: - If it occurs immediately after node disconnect of the 
particular node ignore it, else contact ABB. 
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Table 5-10. Messages with Mcode = 56 and Task Name = HLUCmdnn from C1538 


Trace Number 
(Hexadecimal) 


1 
2 


Parameter Description 


= data1 
= data2 


Comments and Suggested Actions 


0003000f 


1 


2: 


: Block size 


Failed to allocate transceiver buffer. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00030004 


4 


Failed to open transceiver channel. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00030006 


= 


: File Descriptor 


Failed to write to transceiver channel. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00030016 


= 


Failed to get Host information. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00040004 


4 


Failed to open FIFO pipe to the Protocol Handler. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00050028 


ph 


: Semaphore Id 


Failed to take semaphore. 
If it appears during protocol handler restart ignore it, else 
please contact ABB. 


00080017 


a 


Protocol handler illegally sent an upstream command, 
when one upstream command is already pending. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00080023 


2 


1 


Command Info. pointer 


Received illegal pointer from the protocol handler. 
Reset the MVI module, if the problem persists, please 
contact ABB. 
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Table 5-11. Messages with Mcode = 56 and Task Name = HLURmmnn from CI538 


Tidce: Number Parameter Description 
. 1 = data1 Comments and Suggested Actions 
(Hexadecimal) 
2 = data2 
0003000f 1: Block Size Failed to allocate transceiver buffer. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030005 1: File Descriptor Failed to read from the transceiver channel. 
2: Node number Reset the MVI module, if the problem persists, please 
contact ABB. 
00030006 1: File Descriptor Failed to write to transceiver channel. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030023 1: Buffer pointer Received illegal pointer from transceiver interface. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00030024 1: Transceiver Channel File loctl operation on the high priority transceiver channel of 
Descriptor the remote node failed. 
2: Node number Reset the MVI module, if the problem persists, please 
contact ABB. 
00050028 1: Semaphore Id Failed to take semaphore. 
2: Node number Reset the MVI module, if the problem persists, please 
contact ABB. 
0005002d 1: Receiving Task Id Failed to send signal to the task 
2: Signal number Reset the MVI module, if the problem persists, please 
contact ABB. 
0006002b 1: Error number Unexpected exception encountered. 
2: Node number Reset the MVI module, if the problem persists, please 
contact ABB. 
0007002c 1: Node number Illegal up stream response from Host. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
00090013 1: Node number Illegal node number. 
2: - Reset the MVI module, if the problem persists, please 
contact ABB. 
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Table 5-12. Messages with Mcode = 58 and Task Name = MviHdinn from CI538 


Trace Number 
(Hexadecimal) 


Parameter Description 


1 
2 


= data1 
= data2 


Comments and Suggested Actions 


00010005 


1 


2: 


: File Descriptor 


Read from UART failed. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00010006 


=e 


: File Descriptor 


Write to UART failed. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


0001000b 


4 


: File Descriptor 


Failed to fetch event status from UART. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


0001000d 


se 


: File Descriptor 


Failed to fetch modem status from UART. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


0001000e 


4 


: File Descriptor 


Failed to cancel read descriptor. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


0001001e 


php — 


: File Descriptor 


Failed to flush UART. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00020004 


=e 


Failed to open watchdog timer device. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00020010 


4 


: File Descriptor 


Failed to start watchdog timer. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00020011 


= 


: File Descriptor 


Failed to cancel watchdog timer. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00050012 


4 


Select failed. 
Reset the MVI module, if the problem persists, please 
contact ABB. 


00070014 


= 


: PLC register address 
2: Number of registers 


requested 


Illegal register address. The register address has been 
used with wrong function code. 

Check the register addresses in your MVB data base 
element. 
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Table 5-12. Messages with Mcode = 58 and Task Name = MviHdlinn from CI538 (Continued) 


Trace. Number Parameter Description 
: 1 = data1 Comments and Suggested Actions 
(Hexadecimal) 
2 = data2 
00070019 1: PLC register address Illegal Data Request. 
2: Number of registers The MVB must cover the address range specified by 
requested register address = DATA 1 and number of registers = 
DATA 2. Fill in the correct register address. Check the 
REGADDR and NOOFREGS in the MVB data base 
element, or the command from the PLC. 
0007001a 1:- Illegal data value reported from PLC. 
2: - The value referenced in the data field is not allowed in the 
slave. 
0007001b 1: Function code Illegal Function code reported from PLC, or a Function 
2: - code not supported by MVI Protocol received from the 
PLC. 
0007001c 1:- Hardware error reported from PLC. 
2: - 
0007001d 1: PLC register address Illegal data address reported from PLC. 
2: Number of registers The address referenced in the data field is not an allowed 
requested address in the slave. 
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5.4 Fault Finding and User Repair 


5.4.1 Tornado 


If you have followed the instructions in Chapter 2, Installation and Chapter 3, 
Configuration/Application Building, and you still have problems, please check the following: 


1. 


It is Not possible to Launch the Target Server. 


Check that the cable is attached to the COM2 serial port on the Personal Computer, which 
is the default setting. If this port can not be used, modify the settings of the target server in 
Tornado by opening the Configure Target Servers window (see Figure 5-3). This window 
is opened by choosing Configure... from the Tools-> Target Server menu. 

First select the target server in question and then Back End as Change Property. Modify 
the Serial Port field which can be set to any existing serial port on the Personal Computer. 


Check that the core file of the target system exists where it is supposed to be. The target 
server supposes, by default, that the core file (CI538XXX) exists in one of the 
development directories (YYY/work). To get the exact value of the location searched by 
Tornado, open the Configure Target Servers window (see Figure 5-3). This window is 
opened by choosing Configure... from the Tools- > Target Server menu. 

There, first select the target server in question and then Core File and Symbols as Change 
Property. The File field shall contain the path to the core file, and the File radio button 
shall be filled in. If the field does not match the actual file location, move the file or 
modify the File field. 

The core file is one of the two files created when an MVI system is built. These files are 
named CI538XXX and CI538XXX.hex. The file without the hex extension is the core file. 


The default values of the target server have in some way been modified. The crucial fields 
are: 

Back End Type = wadbserial 

Speed = 19200 

Core file = the CIS538XXX file created when you built the system that was prommed with 
the CIS38XXX.hex file. 


Check that you have attached the cable to the correct port on the target. If you have a 
Debug or a 1 channel system, the cable shall be connected to the lower port on the front of 
the CI538 board. 

If you have a 2 channel system (never used during development, only as a final system) it 
is impossible to attach a cable since both front ports are used for MVI communication. 

In reality, there actually is a possibility to access the board even with two MVI channels 
running. Contact ABB if this is absolutely needed. 
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Configure Target Servers AES 


Target Server Descriptions 
DemoProtocal: Demo Debug Target (Clb38Dei New | 
RustiBus: Debug Target (CI538Debug) 


RustiBus: Final Target-1 Channel (CI538_1C) | Copy | 
Description [DemoProtocol: Demo Debug Tar 
Remove | 


Target Server Name 
Change Property [Back End | 


Available BackEnds = Timeout (sec) Re-try (Count) 


netrom 
wdbrpc 
a rt Serial Port Speed (bps) 


[come | fi9200 | 
Log Eile i I 


Command Line 


tgytsvr.exe Serial -c 
f:\MVIProtocols\DemoProtocol\work\Cl538Debug -¥ -m 1048576 
-B wdbserial -b 19200 Ta 


Launch | Cancel | Help | 


Figure 5-3. Configure Target Servers Window with Change Property set to Back End 


2. It is Not possible to Build a System. 


Is MVIBase properly installed? Installation of MVIBase is described in Section 2.2.2.1, 
MvVIBase and User Development Structure. 


Remember that if the build commands in the Project menu are supposed to work, the 
development of the protocol must take place in the development directories created at the 
installation. 
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It is Not possible to Debug. 


To be able to debug an object module downloaded to the target, the path to the directory 
containing the source code must be specified in Tornado. All directories specified are 
listed in the Debugger Source Search Path window (see Figure 5-4). This window is 
opened by choosing Source Search Path... from the Debug menu. 

Check that the directory containing the source code of your object module is listed there. 
If not, add it to the list. 


If the source code file has not been compiled using the Project menu commands, the 
problem might be that the compilation was done without the debug option -g (see the 
Tornado documentation for more information about compiler options). Always compile 
your files from the Project menu. 


Lx 


Debugger Source Search Path 2] 


Directories: 


f:\MYVIProtocols\ DemoProtocol\work 
f:\MvIProtocols\RustiBus work Remove 


__Bemove | 
__Moveup | 
_Move Down | 
__ Senet | 
__ Hee | 


Move Up 


Move Down 


Path: [:\MVIProtocols\DemaProtacol\work 


Figure 5-4. Debugger Source Search Path Window 
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5.4.2 MVI Demo Protocol and other Async. Communication Protocols 


If you followed the instructions in Chapter 2, Installation and Chapter 3, 
Configuration/Application Building and still do not have a correctly working communication 
link, please check the following: 


1. Are Modems and Cables correctly Set-up? 


The CI538 must receive the correct modem signals. When you select full duplex mode for 
the modem signals, the signal Data Set Ready (DSR), Data Carrier Detect (DCD) and 
Clear to Send (CTS) must be set. In half duplex mode the DSR must be set and DCD and 
CTS toggle between 0 and 1. 


Current DSR, DCD and CTS values are available in the data base element MVICHAN. 


NOTE 


Displayed values from the MVICHAN element on the engineering station are not 
always synchronized to the actual value change of the modem signals; short 
pulses may not be displayed. 


The modem signals are set up by the modem or, in full duplex mode, you can wire them in 
the 9-position connector on cable TK577, or in the 9-position connector on the MVI side 
on cable TK595 (see Figure 2-6). 


2. Is the MVIMOD Data Base Element correctly Filled in? 


You must define the same node number for all the communication boards in an Advant 
Controller 400 node. All network numbers in the Advant Controller 400 node must be 
unique (for CI538 1-9). 


POSITION and SUBPOS must match the actual position of the submodule. 
IMPLEMENTED and SERVICE must be set to one. CHANNEL1 and/or CHANNEL2 
must refer to the correct MVICHAN element. 


If the network number or node number for any of the communication modules in the 
Advant Controller 400 is changed after the start-up of the node, the Advant Controller 400 
must be COLD STARTED. Connect an engineering station to the Advant Controller 400 
and make a DUAP, press ENTER on the main CPU with start-up switch in “CLEAR” 
position and make a LOAP. 


3. Check the Data Base and PC Program Application. 


a. The Configuration data base elements (MVICHAN and MVINODE data base 
elements) must be built. The green LED on the CI538 submodule is lit when the 
configuration is successfully transferred to the submodule. 


b. In master mode, the MVB data base elements must be built and the PC program with 
SENDREQ-elements for the flow control must be built and started. 


c.  Inslave mode, the MVB data base elements for data transfer must be built. 
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Are there any System Messages reported in Advant Controller 400? 


Check system messages by connecting an engineering station to the Advant 
Controller 400. Also check the system messages when you restart the CI538. 


To restart the module, set the terminal SERVICE to 0 and back to 1 in the MVIMOD 
element. All configuration errors are reported at start-up. Error messages with Mtype 29 
are translated in Section 5.3, Error Messages. 


NOTE 


Some errors are only reported once. 
Which Status Bits are set in the MVINODE Data Base Elements, Section 
STATUS1? 


VALUE (bit0) is set when the Advant Controller 400’s connection to the PLC is 
established, see Table 3-8. 


If you know the answers to the following questions, further analysis will be easier: 


a. Are modems and cables installed as described in the Advant OCS Installation Rules 
manual? Pay particular attention to the power supply and connection to signal 
ground. 


b. How is your control system configured? A block diagram with all node and network 
numbers is useful. Note also the type of PLC, the master and slaves on the link and 
the type of modem you are using. 


c. Have you made any significant changes in your configuration (for example, new 
communication board(s) added, new modems)? 


d. Is it possible to repeat your problem? 
e. Have you found any way to circumvent the problem? 


f. | Have you made any other observations related to the problem? 


A test tool for monitoring the status of the V.24 leads is also useful for further analysis. 

The test tool shows the status, with LED indicators, of the modem signals, data transmission 
(TD) and reception (RD). When an analysis of the data flow on the MVI link is necessary, you 
need a Serial Line Analyzer that monitors and stores the messages sent on the link. 


NOTE 


Some of the points in the list above are not applicable on the MVI Demo Protocol 
alone, but may be relevant for any asynchronous communication protocol 
developed. 


3BSE 015 373R0001 


MultiVendor Interface - Protocol Development Kit Advant® Controller 400 Series User’s Guide 
Section A.1 MVI Demo Protocol Configuration and Application Building for Advant Controller 400 


Appendix A MVI Demo Protocol Configuration 


A.1 MVI Demo Protocol Configuration and Application Building for Advant 
Controller 400 


This section describes the data base elements used to configure the MVI Demo Protocol. 

They contain setup information for the CI538’s hardware and software. Status and Diagnostics 
information is also received from the MVI Demo Protocol. The Status and Diagnostics 
information can be used by the application program. 


A.1.1 MVICHAN Configuration for MVI Demo Protocol 


The line characteristics of CI538 are specified in one MVICHAN data base element for each 
communication channel. For general information, see Section 3.5.7.1, MVICHAN Data Base 
Element. 


Mvcl 


MVI Channel 
(356.1) 


S14 Base part 


S2 4 Communication 


S3 4 Parameters 


_| PROTTYPE VALID | 
_| DUPLEX DSR L 
| DIAL cTS - —| PARAM1 
_| SPEED DCD —| PARAM2 
—| CHLEN RIE —| PARAM3 
+ STOPBITS —| PARAM4 
—| PARITY —| PARAMS 
_| LINESTAB —| PARAM6 
| CARRDEL —| PARAM7 
—| MAXRETR —| PARAM8 
—| CHARTOUT —| PARAMS 
—| NAME ERR + —_| TURNTIME —]| PARAM10 
—| MASTER ERRTYPE + — UARTTOUT —]| PARAM11 
_| TIMESYNCH NET - | POLLCYCL —]| PARAM12 
Base part Communication Parameters 


Figure A-1. Overview of MVICHAN Data Base Element 
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Base Part 
MVCl 
MVI Channel 
(356.1) 
MVC1 1 4 NAME ERR 
a 2 MASTER ERRTYPE 
NONE 3 4 TIMESYNC NET | 
s2 + Communication 
$34 Parameters 


Figure A-2. Data Base Element MVICHAN Base Part for MVI Protocol 


Table A-1. Terminal Description for MVICHAN Base Part 


Terminal valle Recommended ES 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 
1 NAME User MVCx - Unique element NAME. Maximum 20 
characters 
2 MASTER User Oor1 B(r/w) MVI channel in: = 
0 = slave mode 
1 = MASTER mode 
3 TIMESYNC User NONE = MVI TIME SYNChronization is not — 
applicable. 
4 ERR System 0 Bir) ERRor. - 
5 ERRTYPE System 0 IL(r) ERRor TYPE. - 
6 NET System 0 I(r) NETwork number of MVI channel. - 
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Communication Part 


Mvcl 


MVI Channel 
(356.1) 


Base part 


n 
fay 
| 


ae 
H 
PD 
C 
Q 
4 
n 
a 
ad 
oO 


ODATDUBWNROWYW 

n 
43 
° 

U 
w 
H 
4 
n 


S34 Parameters 


Figure A-3. Data Base Element MVICHAN Communication for MVI- Protocol 


Table A-2. Terminal Description for MVICHAN Communication Part 


Terminal value Recommended bs 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 
9 PROTTYPE User 20 I(r/w) PROTocol TYPE. 0..255 

10 DUPLEX User FULL I(r/w) DUPLEX mode, concerns modem - 
signals between MVI channel and 
modem. Values: 
FULL, HALF, HALFNODCD (DCD 
IGNORED) 

11 DIAL User 0 B(r/w) DIALing. - 


0 = disabled Not supported by MVI 
Demo Protocol. 


12 SPEED User 9600 I(r/w) Transmission SPEED of = 
communication in bits/second. Values: 
150, 300, 600, 1200, 2400, 4800, 


9600, 19200 

13 CHLEN User 7 I(r/w) CHaracter LENgbth in bits. Values: = 
7,8 

14 STOPBITS User 1 I(r/w) STOP BITS. Values: = 
0.5, 1, 1.5, 2 

15 PARITY User EVEN I(r/w) PARITY. Values: = 


NONE, ODD, EVEN 
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Table A-2. Terminal Description for MVICHAN Communication Part (Continued) 


Terminal 
No. 


Terminal Name 


Value 
entered 
by 


Recommended 
Value 


PC 
Connection 
Data Type 


Description 


Remarks 


16 


LINESTAB 


User 


0 for full duplex 
1 for half duplex 


I(r/w) 


LINE STABilization time in number 

of character transmission times. 

Time to allow the carrier wave to 
stabilize before transmission of the first 
character. Restrictions for half duplex: 
“(own) LINESTAB time = (opposite 
side) CARRDEL time”. See Figure A-5. 


0..15 


17 


CARRDEL 


User 


0 for full duplex 
1 for half duplex 


I(r/w) 


CARRier DELay time in number of 
character transmission times. Time to 
wait after the transmission of the last 
character before deactivating RTS. 
This delay is used to avoid destruction 
of the last character in the message, 
due to lost carrier. See Figure A-5. 


18 


MAXRETR 


User 


2 for master 
0 for slave 


I(r/w) 


MAXimum number of 
RETRansmissions before line is 
considered broken. 


19 


CHARTOUT 


User 


I(r/w) 


CHARacter Time-OUT time in number 
of character transmission times. Used 
by receive routine to detect idle receive 
line. 

0: no check for time-out is made. 


20 


TURNTIME 


User 


100 


IL(r/w) 


TURN around TIME in milliseconds. 
Time to wait as from the last character 
in the command until the first character 
in the reply, i.e. the time-out time. 


0..20000 


21 


UARTTOUT 


User 


1 for full duplex 
2 for half duplex 


I(r/w) 


UART transmission Time-OUT in 
number of character transmission 
times. If half duplex is used, a check of 
DCD will be made by the send routine 
before activating RTS. 

If DCD is activated the send routine will 
wait for DCD to be deactivated up to 
this time before aborting the 
transmission. 


22 


POLLCYCL 


User 


96000/SPEED for 
master 
1.2*96000/SPEED 
for slave 


I(r/w) 


Maximum time between two POLLing 
CYCLes in seconds. 


0..255 


38 


VALID 


System 


Signals DSR etc. is VALID 


39 


DSR 


System 


Modem signal Data Set Ready. 


40 


CTS 


System 


Modem signal Clear To Send 


41 


DCD 


System 


Data Carrier Defect 


42 


Rl 


System 


Modem signal Ring Indicator. 


A-4 
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Parameters Part 


MvCl 


MVI Channel 
(356.1) 


Base part 


Communication 


Oo. om: OO ao: o> 


Figure A-4. Data Base Element MVICHAN Parameters for MVI Protocol 


These parameters are mostly used when implementing a dial-up protocol. 


Table A-3. Terminal Description for MVICHAN Parameter Part 


F Value PC 
Terminal : Recommended : 7 

Terminal Name | entered Connection Description Remarks 

No. Value 

by Data Type 

23 PARAM1 User IL(r/w) Protocol specific parameters. gee! 

to to Not used by the MVI Demo Protocol. 

30 PARAM8 

31 PARAM9 User - A20(r/w) | Protocol dependent string parameter. | Maximum 20 

46 to Not used by the MVI Demo Protocol. | characters 

47 PARAM12 

48 
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The CI538 submodule must always be restarted if the references ina MVICHAN 
element are changed. It is not enough to just change the values. 
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RTS = 

Request To Send 

Carrier 

CTS = 

Clear To Send 

Daa LINESTAB CARRDEL 
> 


Figure A-5. LINESTAB and CARRDEL in Half Duplex Mode 


ee | LE Message from AC 400 
AC 
400 Answer from PLC 
W'T2 


Turn-around time = T2 - T1 


Figure A-6. Turn-around Time 


A-6 3BSE 015 373R0001 


MultiVendor Interface - Protocol Development Kit Advant® Controller 400 Series User’s Guide 
Section A.1.2 MVINODE Configuration for MVI Demo Protocol 


A.1.2 MVINODE Configuration for MVI Demo Protocol 


Every node on a MVI local control network is represented by a data base element of type 
MVINODE. The element specifies: 


° In master mode: Each slave node on the bus is represented by one data base element. 


° In slave mode: Only one data base element representing the slave node view of the master 
node is needed. 


MVN1 
MVI Node 
(357.1) 
S1_}] Base part 
S2_] Status 1 (1-16) 
S3— Status 1 (17-32) 
S4_{ Status 2+3 
VALUE |_ VAL 
—| NAME VALUE2 |— VAL 
—| ACT VALUE3 |— VAL 
—| NET VALUE4 |— VAL 
—| REMNODE VALUES | VAL 
— NODETYPE VALUE6 | VAL 
— STRING1A VALUE7 }— VAL 
— STRING1B VALUES }— VAL 
—| STRING2A VALUEQ |-— VAL 
—| STRING2B VALUE10 |— VAL 
—| STRING3A VALUE11 / VAL 
— STRING3B VALUE12 — VAL 
—| STRING4A VALUE13 | VAL 
— STRING4B VALUE14 [— VAL 
—| STRINGSA VALUEL5 }— Mave pLATUS a= 
— STRING5B VALUE16 |— VAL STATUS3 |— 
Base part Status 1 (1-16) Status 1 (17-32) Status 2+3 


Figure A-7. Overview of MVINODE Data Base Element 
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Base Part 


MVN1 
MVI Node 
(357.1) 
MVN1 1 NAME 
1 2 ACT 
1 3 NET 
a 4 REMNODE 
0) 5 NODETYPE 
6 STRINGIA 
fl STRING1B 
8 STRING2A 
9 STRING2B 
10 STRING3A 
11 STRING3B 
12 STRING4A 
13 STRING4B 
14 STRING5SA 
15 STRING5B 
$2] Status 1 (1-16) 
s3—| Status 1 (17-32) 
S4 Status 2+3 


Figure A-8. Data Base Element MVINODE Base Part for MVI Protocol 


Table A-4. Terminal Description for MVINODE Base Part 


Terminal Value Recommended ee 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 
1 NAME User MVNx = Unique module NAME. Maximum 20 
characters. 
2 ACT User 1 B(r/w) O=the element is spare - 
1=the element is ACTive 
3 NET User 1 - NETwork number of remote node. 0..9 
4 REMNODE User 1 I(r/w) REMote NODE number. 0..99 
5 NODETYPE User 0 I(r/w) Remote NODETYPE. 0..32767 
6 STRING1A User - A20(r/w) STRING 1A. Maximum 20 
Not used in the MV! Demo Protocol. | characters. 
7 STRING1B User - A20(r/w) STRING 1B. Maximum 20 
Not used. characters. 
15 STRING5B User - A20(r/w) STRING 5B. Maximum 20 
Not used in the MV! Demo Protocol. | characters. 
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MVN1 MVN1 
MVI Node MVI Node 

(357.1) (357.1) 

—_— S1— Base part —— Sl — Base part 

VALUE }— 17 ———_— — §2-|] Status 1 (1-16) 
VALUE2 | 18 
VALUE3 -— 19 VALUE17 |— 33 
VALUE4 |~ 20 VALUE18 |— 34 
VALUES | 21 VALUE19|~— 35 
VALUE6 |— 22 VALUE20 | 36 
VALUET7 | — 23 VALUE21 | 37 
VALUE8 |— 24 VALUE22 | 38 
VALUES |— 25 VALUE23 |— rf 
VALUE10 |— 26 VALUE24 |— 44 
VALUE11 | 27 VALUE25 |— 45 
VALUE12 |-— 28 VALUE26 |— 43 
VALUE13 | 29 VALUE27 |— gq 
VALUE14 /- 30 VALUE28 |— 45 
VALUE15 [|-~— 31 VALUE29 | 45 
VALUE16 | 32 VALUE30 | 46 
VALUE31 |~ 47 
—— S3—| Status 1 (17-32) VALUE32 | 48 
———. §4-| Status 2+3 —— $4_] Status 2+3 


Figure A-9. Status I (1-16) / Status 1 (17-32) 


Status1 


Contains information required for flow control, among other things, see Table A-5, below. 


Table A-5. Status 1 


. Value PC 
Terminal ‘ Recommended 7 20 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 
17 VALUE System - B(r) Link status Slave and 


The corresponding PLC reachable, master 
see Figure 3-32 


Set to “1” when the remote node is 
reachable. 

Set to “O” when contact with remote 
node is lost (including restart of 
C1538). 


The master considers the contact lost 
after maximum number of 
retransmissions without an answer. 
The slave node considers the contact 
lost when the times between 
messages from the master exceed 
the poll cycle time. 
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Table A-5. Status] (Continued) 


Terminal ue Recommended Bud 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 


18 VALUE2 System - Bir) Reserved. 


19 VALUE3 System - Bir) Reserved. 


20 VALUE4 System - B(r) Illegal register address received Master 
Set to “1” when illegal register 
address is received from an AMPL 
application command. 

Set to “0” when receiving valid 
register address. 


21 VALUE5 System - B(r) Illegal Function code received Master 
Set to “1” when illegal Function code 
is received from an AMPL application 
command. 

Set to “0” when receiving valid 
function code 


22 VALUE6 System - Bir) Ready for Message Master 
Set to “1” when no command is 
pending, from the application to the 
PLC. 

Set to “0” when a command is 
pending, from the application to the 
PLC. Used by the PC program for 
flow control, see Figure 3-32. 


23 VALUE7 System - B(r) Reserved. Master 


24 VALUE8 System - B(r) Reserved. Master 


25 VALUE9 System - B(r) Illegal Function code reported from | Master 
PLC 

(MVI Demo Exception response 
Code 1). The function code can not 
be handled by the PLC. 


Set to “1” when response code 1 is 
received. Set to “O“ when C1538 is 
restarted. 


26 VALUE10 System - B(r) Illegal data address reported from Master 
PLC 

(MVI Demo Exception response 
Code 2). The address referenced in 
the data field is not an allowed 
address in the slave. 

Set to “1” when response code 2 is 
received. Set to “O“ when C1538 is 
restarted. 


27 VALUE11 System - B(r) Reserved. Master 
to to 
48 VALUE 32 
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MVN1 
MVI Node 
(357.1) 
—— S1— Base part 
— S$2— Status 1 (1-16) 
—— S34 Status 1 (17-32) 


Status2 and Status3 (Integer Long) 


STATUS2 |— 49 
STATUS3 +_ 50 


Figure A-10. Status 2+3 


If the CI538 submodule receives an illegal address or function code, either from an AMPL 
configuration program or from a PLC, Status2 and Status3 show additional information. 
See Table A-6. 


Table A-6. Status2 + Status3 (Integer Long) 


. Value PC 
Terminal : Recommended . sys 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 

49 Status 2 System | - IL(r/w) If Status! VALUE4 = 1 or VALUE10 =| 0-23! 
1, thatis, an address error, the Status2 
holds the address that caused the 
error. Status2 is reset at restart of the 
Cl538 

50 Status 3 System | - IL(r/w) If Status 1 VALUES = 1 or O27! 
VALUE10 = 1, that is an illegal 
Function Code, the Status 3 holds the 
Function code that caused the error. 
Status 3 is reset at restart of the C1538. 
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A.1.3 MVI Data Block Element (MVB) 


A-12 


The MVI Data Block element specifies either data transmission to other MVI nodes or 
commands sent locally to the protocol handler on the MVI submodule. When used for data 
transmission, the MVB data base element on the sending side both specifies a command and 
holds the data for transmission. On the receiving side, the MVB data base element just holds the 


data. 


Described here is a sending MVB in Master mode. 


—| IDENT 

-| NET 

—| REMNODE 
—-| SOURCE 

— ACT 

— BLOCKED 
— SCAN_FTR 


—| NAME VALID 


ERR 


MVB1 


Base part 1 


—| CMDCODE 
—| AUXINFO1 
—| AUXINFO2 
—| AUXINFO3 
—| REGADDR 
—| NOOFREGS 
—| DATREF 

—| BITREF 

—| NO_BREC 
—| NO_LINT 

—| NOLINTL 
—| NO_LREAL 


Base part 2 


MVI Data Block 
(358.1) 


Base part 1 


Base part 2 


Value ref. 1-16 


Value ref. 17-32 


Value ref. 33-48 


Value ref. 49-64 


Value ref. 65-80 


Value ref. 81-96 


Value ref. 97-112 


Value ref. 113-128 


_) REF1 
-| REF2 
+ REF3 
_| REF4 
_| REF5 
_| REF 6 
_| REF7 
_| REF8 
_| REF9 
_ REF10 
+ REF11 
_ REF12 
_| REF13 
_ REF14 
_ REF15 
— REF16 


Value ref. 1-16 


Value ref. 17-32 _| 


Value ref. 33-48 = 


Value ref. 49-64 a 


Value ref. 65-80 + 


Value ref. 81-96 + 


Value ref. 97-112 + 


REF113 
REF114 
REF115 
REF116 
REF117 
REF118 
REF119 
REF 120 
REF121 
REF122 
REF123 
REF124 
REF125 
REF126 
REF127 
REF128 


Value ref. 113-128 


Figure A-11. Overview of MVB Data Base Element 
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Base Part 1 


MVB1 
MVI Data Block 
(358.1) 

1 NAME VALID |_- 18 — 

3 IDENT ERR |} 24 — 
20 _ NET 

21 REMNODE 

17 SOURCE 

2 ACT 

19 BLOCKED 

22 —| SCAN_FTR 

S2 Base part 2 

$3 Value ref. 1-16 

S4 Value ref. 17-32 

s5 Value ref. 33-48 

Sé Value ref. 49-64 

S7 Value ref. 65-80 

S8 Value ref. 81-96 

$9 Vaiue. bet. Vi-112 
S10 Value ref. 113-128 


Figure A-12. MVB Base Part 1 


Table A-7. Terminal Description of MVB for Base Part I 


Terminal value Recommended Pe 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 
1 NAME User MVBx = Unique module NAME. Maximum 20 
characters. 
3 IDENT User - _ IDENTity. A number which must be 1..255 
unique for a combination of NET and 
REMNODE. 
20 NET User 1 - NETwork number. Defined at the 1..9 
MVIMOD data base element for the 
C1538. 
21 REMNODE User 1 - REMote NODE number. RTU number | 1..99 
(node) of the receiving RTU. 
REMNODE must be the same as in the 
corresponding MVINODE. 
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Table A-7. Terminal Description of MVB for Base Part I (Continued) 


Terminal qalue Recommended ee 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 
17 SOURCE User SEND - SOURCE. Direction of the data - 
transmission. 
RECEIVE = Receiving MVB 
SEND = Sending MVB 
2 ACT User 1 B(r/w) Element is ACTive. = 
0 = Element is spare 
1 = Element is active 
19 BLOCKED User 1 B(r/w) BLOCKED. Cyclic execution of the | The cycle 
specified command is: time is 
0 = Not blocked defined by 
1 = Blocked the terminal 
SCAN_FTR. 
22 SCAN_FTR User 4 - SCAN FacToR. 1..127 


In multiples of basic scan cycle time 
(default 1 second). 


18 VALID System | — B(r/w) VALID - 
SOURCE = SEND: 

Set to 1 after the first execution of 
MVB. 

SOURCE = RECEIVE: 

Set to 1 after reception of DAT’s. 

The terminal will be reset by the 
system if no DAT’s are received within 
the supervision time of 3*SCAN_FTR 
basic scan cycle time. 


24 ERR System | — B(r) ERRor. Set if an error occurred. = 
AC 400 sends a system message to 
indicate the nature of the problem. 

0 = No error 

1 = Error 
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Base Part 2 


MVB1 


$1 4 


WRITE I 


MVI Data Block 
(358.1) 


Base part 1 


CMDCODE 
AUXINFO1 
AUXINFO2 
AUXINFO3 
REGADDR 
NOOFREGS 
DATREF 
BITREF 
NO_BREC 
NO_INT 
NO_INTL 
NO_REAL 


Value ref. 1-16 


Value ref. 17-32 


Value ref. 33-48 


Value ref. 49-64 


Value ref. 65-80 


Value ref. 81-96 


Value ref. 97-112 


S10 


Value ref. 113-128 


Figure A-13. MVB Base Part 2 
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Table A-8. Terminal Description of MVB for Base Part 2 


Terminal Value Recommended iad 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 
6 CMDCODE User - CoMmanD CODE to be executed. - 
The MVI Demo Protocol supports two 
data transaction command codes: 
READ I - Read 16bit integer 
register(s) 
WRITE | - Write 16bit integer 
register(s) 
The MVI Demo Protocol supports three 
control command codes: 
RESTART HANDLER - Restart 
protocol handler. 
RESET DIAGNOSTICS -— Reset 
diagnostic data. 
GET DIAGNOSTICS - Retrieve 
diagnostic data. 
9 AUXINFO1 User - IL(r/w) AUXiliary INFOrmation 1 0..291 
Not used by the MVI Demo Protocol | Only used in 
Handler. master 
mode. 
10 AUXINFO2 User - IL(r/w) AUXiliary INFOrmation 2 0..291 
Not used by the MVI Demo Protocol | Only used in 
Handler. master 
mode. 
11 AUXINFO3 User = A20(r/w) | AUXiliary INFOrmation 3 Maximum 20 
Not used by the MVI Demo Protocol | characters. 
Handler. 
4 REGADDR User 1000 - REGister start ADDRess. 0.29! 
First register address to be transferred. 
5 NOOFREGS | User 2 I(r/w) NO OF REGisterS. 0.22! 
Number of registers to be transferred. 
7 DATREF User 0 I(r/w) DAT REFerence in this element 0..110 or 
(max 110 for BREC, INTL or REAL, |0..128 
128 for INT DATs). 0 indicates 
Not used by the MVI Demo Protocol | that the 
Handler. terminal is 
not used. 
Only used in 
master 
mode. 
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Table A-8. Terminal Description of MVB for Base Part 2 (Continued) 


Terminal value Recommended Ee 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 
8 BITREF User 0 I(r/w) BIT REFerence in the above selected | 0..32 
DAT. 0 indicates 
Not used by the MVI Demo Protocol | that the 
Handler. terminal is 
not used. 
Only used in 
master 
mode. 
12 NO_BREC User 0 = Number Of Boolean RECords DAT(B), 0..110 
Not used by the MVI Demo Protocol 
Handler. 
13 NO_INT User 2 7 Number Of INTeger records DAT(I). | 0..128 
This is dependent on which 
CMDCODE that is chosen for the 
MVB. If a READ | command is to be 
executed, integer records are of 
course necessary. 
14 NO_INTL User - Number Of INTeger Long records 0..110 
DAT(IL). 
Not used by the MVI Demo Protocol 
Handler. 
15 NO_REAL User - Number Of REAL records DAT(R). 0..110 
Not used by the MVI Demo Protocol 
Handler. 
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MVB1 


MVI Data Block 
(358.1) 


Sl + Base part 1 


S2 + Base part 2 


REF 1 
REF 2 
REF3 
REF 4 
REF 5 
REF 6 
REF 7 
REF 8 
REF 9 
REF 10 
REF 11 
REF 12 
REF 13 
REF 14 
REF15 
REF 16 


Oy OVO COs OF EAL Eee Ee 


PRPRPRPRER 


lue ref. 17-32 


Wn 
ww 
! 
< 
i) 


lue ref. 33-48 


n 
a 
! 
< 
o 


lue ref. 49-64 


n 

o 
! 
< 
o 


S7 4 Value ref. 65-80 


sg + Value ref. 81-96 


S9 +Value ref. 97-112 


810 4 Value ret. 113-128 


Figure A-14. Value Reference 1-16 


The value references 17-128 are analogous to Value Reference 1-16 


Table A-9. Terminal Description for MVB Value Reference I - 128 


Terminal value Recommended ie 
Terminal Name | entered Connection Description Remarks 
No. Value 
by Data Type 
16(1) REF1 User - - REFerence: Name of connected | If an MVB has 
DAT element (number 1). the name 
"MVB1” and 
16(2) REF2 User - - REFerence: Name of connected /NO_INT has the 
DAT element (number 2). value 1, the 
name of the 
: connected DAT 
REFerence: Name of connected | elements will be: 
16(128) | REF128 lisér Z DAT element (number 128). MVB1.I1 
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A.1.4 PC Program Layout 


To control the data flow on the asynchronous communication link, you must build a PC program 
in the Advant Controller 400. The PC program receives status information from the MVI Demo 
Protocol. 


The flow control is maintained through a chain of SENDREQ PC elements, each corresponding 
to a MVB to be transmitted. See Section 3.5.7.6, PC Program Layout. 
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Appendix B Hardware Module 


B.1 CI538 Communication Interface 


CI538 communication interface has: 
° Two RS-232-C communication interfaces 


° Modem support. 


Description 


CI538 Multi Vendor Interface is a submodule which is to be mounted in the submodule carriers SC510 and SC520 in 
Advant Controller 450 and Processor Module PM150 in Advant Controller 410. The two RS-232-C communication interfaces 


are used for communication with asynchronous communication protocols. 


The communication channels support communication speeds up to 19.2 kbit/s, which is the limit set by the system software. 


Both channels can run at this speed simultaneously. 


The maximum communication distance without modems is 15 m. The modem signals which are supported can be found in 


Table B-1 below. 


Communication PINs are short-circuit proof. 


Flash PROMs $80000-FFFFF $0-7FFFF 


Be ODD 


cis, BB I 
5) RUN-LED 
E |— 
a o| 
172 
oO FAULT-LED — 
CHANNEL 1 
| (x4) E x 
E 
ey x2 
y ~ N 
iS 
CHANNEL 2 
| (XS) 
© 1 2 
E a 
Front View 


Figure B-1. CI538 Submodule 
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Technical Data 


Indicators 
LED R, Run (green) on module front. Indicating module running normally. 


LED F, Fault (red) on module front. Indicating a fatal error detected on the CI538 module. 
The LED is also turned on at reset of the module. 


Jumpers 


The board contains one jumper for special purposes. In normal operation always keep the S1 in position 3 - 4 (“parking place’). 
The component and position indications are found on the printed circuit board. 


Connectors 

Serial channels | and 2 connectors (X4 and X5): 

¢ Connector type 9-pole male DSUB (DE9P) 
e Placement On module front 


¢ Pin designation See Table B-1 below. 


Table B-1. Pin Designation for Channels I and 2, Connectors X4 and X5 


Pin Short Description 


oa 


DCD Data Carrier Detect 


RD Receive Data 


TD Transmit Data 

DTR Data Terminal Ready 
GND Ground 

DSR Data Set Ready 

RTS Request To Send 
CTS Clear To Send 


OO; OI N| oO] ay; &] wy] Pp 


RI Ring Indicator 
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Power Supply 

SV typical 400 mA 
max. 670 mA 

24V max. 40 mA 

Power loss (heat) typical 3W 


Mechanical Data 


Module size: Occupying one submodule slot (H = 95 mm, L = 140 mm, connectors not included). 


Weight: 0.13 kg. 
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